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I. INTRODUCTION 


The Vector General Graphics Disolay Unit in conjunction 
with the POoR=)) 7/50 minicomputer Orovides the Naval 
pestaoraduate’ Schoo! Ceomouter Laboratory with a sophisticated 
three=dimensional Grapni1es disolay system. Hardware 
facilities Sirev1de Por three-dimensiona] rotation, 
translation, and scaling of araohics data. Deoth=cueing 1s 
accomolished by varying object intensity. A EeyrcleAarc 
generator, in addition to a vector and character generator, 
further enhances the system by allowing the user to draw 
Sees ama circles @aith soecification of only two or three 
points. Additionally, external devices in the form of = an 
alohanumeric keyboard, liahted function switches, control 
GvalS, trackball, joystick, and lightoen provide interactive 
Semtcrol of the disolay presentation. 

Integral to the oneration of the Vector Genera} is tne 
eisalay controller. The display controller is a processor 


which receives cata from a disolay 11st, gecodes the data 


into graphic commands, and activates the aporopriate 
g@merator to Cutout the desired information. The 
Sqmstruct ion and maintenance of the display list is 


accomplished through the use of the Vector Genera|} Graphics 
moran y . The liprary functions as the interface between tne 
user and display controller. Simole orimitives are provided 


allowing the user to build the disolay list. Additionally, 





the software allows the display controller to communicate to 
the user information obtained from external devices which 
may be used to programatically control the display 
pre@entation. 

Previous thesis work by Thorpe (11) CL 2 it 1 SCOmPULS iy 
and Stankowski [E10] provided fundamental graphics software 
ames mOuNcd je consultea for original _ design considerations. 
The objective of work described in this thesis was to 
review, modifyr and extend orevious work to provide more 
useable graphics software for the Vector General Display 
System. To this extent certain goals were set. Al] 
previous work was to be reviewed, revised and updated. A 
significant portion of time was to be spent in testing and 
debugging oreviously untested routines. The design and 
imolementation of software to supoort the trackball, 
1OmSieac K » and lightpen facilities was to be undertaken. 
Extension of existing routines to simolify their apolication 
had to be accomplished. Exoansion of application |anguages 
which supoort vector graphics to include BASIC and FORTRAN 
was seen aS a most significant goal of the research. The 
culmination of the study was seen to be the comoilations 
testing, and evaluation of all existing and newly generated 
software, and the incorooration of al! relevant information 


into one user-oriented reference manual. 








II. BACKGROUND 


As most of the work discussed in this thesis concerns 
modifications and extensions to orevious thesis work, a 
@eserveotion of prior work is in order. Thorpe and Raetz 
i} Ve) Seatenecmwsthne —Orl1gimal data structures for 
constructing and maintaining the display list. The display 
list was constructec by a series of subroutine calls which 
oroduced the correct sequence of graphic commands resulting 
in a OP! Sture’ cemeration. 

The disolay was constructed on three Plerareh ican 
levels: oicture, object, and element. An element is the 
smallest picture seament that can be referenced. Ne 
consists of a sequence of move, line, arc, circle, and 
character commands. 4n element must be associated with an 
object before it can be disolayed and an object may comprise 
Eeeorimummot PO elements. A picture refers to all the data 
Gyeeiayec om the screen and may consist of uo to 10 objects. 

Visco (15] was concerned with the design of a multi= 
orocessor system to suoport real-etime interactive graphics. 
Due to the high oriority of direct memory access (DMA) 
requests necessary to suooort refresh Geacnres, st ne. mult i= 
Orocessor configuration was envisioned as a solution to the 
OMA bus tiesuo oroblem. Previous work done by Thorpe and 


Raetz was modified by Visco to conform to the envisioned 








sys fém. 

Stankowski (10) expanded upon previous work by allowing 
the user to construct elements and objects with alphanumeric 
names replacing the oprevious numbering convention. The 
object "TREE" could now contain elements “branchl1" through 
"branch10". Additionally, Stankowski desiqned a number of 
routines for the user to more easily construct a display 
ist . 

O'Dell] (seraccomplished the imolementation of a 
segmented-orocess memory management UNIX onerating system 
that had been oreviously desianed by Emery Csi; 
Additionallv,r, desian and implementation was done in a dual- 
ported memory environment where designated oortions of core 
were sharadDle reqions. O'Dell’'s work nelped Jay the 
Groundwork for a more generalized system in which additional 
languages could supoort graohics orograms. 

Previous oaragraphs have oresented work completed oprior 
to the commencement of research reported in this thesis. 
The adecuacy of the interface between the user and Vector 
General was still i@uaeGOuot. cOoftware tor the trockbdall, 
joystick, and lightoen facilities was missing and routines 
for other external devices were not readily useable. 
Although routines were present to construct and maintain the 
disolay list, the majority of them had not been tested. 
Gompatapility with CO'Dell‘s SSUNIX and expansion of 
available tanguaqges beyond the C language had yet to be 
secomolished. With this in mind, San OeSecEVotions of the 


modifications and enhancements to the system is presented in 


10 





the following sections. 
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TIT. LANGUAGE EXPANSION 


A. GENERAL 


In reviewing the Vector General Display System and the 
Naval Postgraduate School Graphics Laboratory, it was noted 
that most of the software was written in C programming 
language. This circumstance demanded that any further 
language introduction would require Compatability with C and 
the UNIX PDPe-11 operating system. Two lanaquages decame the 
focus of attention due mainly to their wide use and apparent 
Bemmrty to call € subroutines. Versions of BASIC and 
FORTRAN were chosen as the lanquages to attempt 
imolementation with the Vector General software. As work 
PDrocressed on these languages, strengths and weaknesses were 
noted for both that could effect further development and use 
throughout the Graphics Laboratory. The following two 
Seetions will explore each language, theve origins and 


difficulties in develocoment, and implementation. 


oe bMS IC 


Waeeackoround 

In previous work, Robertson [9] implemented an Extended 
Bersre compiler. BASIC (Beginner's Alleourvose Symbolic 
Instruction Code) was originally developed at Dartmcuth 


College and has underaqone many changes to suit user needs. 


lie 





The extensions imolemented by Robertson include such items 
as string manipulation, sequential access to external files, 
multisdimensional arrays, logical operators for numeric. and 
Seminig euagntities, and the ability to call C subroutines. 

The Extended BASIC compiler, hereafter referred to as 
Simoly BASIC, is mot a ourely interpretive compiler. It 
generates an intermediate code (POP-11 assembly lanquaqge) 
from the BASIC source proaram. BASIC object modules and C 
Subroutine odject modules are able to be linked together. 
One final link and load operation orovides the ultimate 
interface between the two different lanquage modules. 

The first step in understanding BASIC was to follow the 
operation Ont the she] |] command which controls” the 
compilation, assemblys and linking. This shell command, 
LBAX, is a userw~accessible executable command on the Naval 
Postgraduate School's UNIX POP=-11 file system. The command 
goes through three phases of operation, all of which depend 
on the option codes included (switches set) when the command 
is- 1Ssued. The first phase is the compile phase. This 
phase compiles the BASIC orogram source code and emits a 
POP -11 assembly language “fale “as the output. The second 
phase causes the assembly of this assembly language file 
uSing the UNIX assembler command "as". This assembly emits 
ae aeout  filhewfor use in a final linkina and loading 


ohase. The final ohase uses the UNIX system loader command, 


"la", to link and load al) necessary object modules. The 
LBAX she]] command automatically loads the resoective BASIC 
and C libraries tc reconcile all] undefined references. The 


eS 








emmeut of this final link and load ohas@® is an executable 
Saagt file. @Within this final stage of the LBAX command, 
Bee Otlom 1S Imvoked to MeGulate the UNIX loader. This "=X" 
Switch option causes al! C internally generated labels to be 
disregarded while retaining only those symbols local to the 
routines themselves. The same switch is also used in the 
loading phase of the C compile shell command "cc". 

Provisions in the compilation ohase of a BASIC program 
ensure the emission of the oroper assemdly languaae code 
that allows interaction vetween the BASIC proaram and the C 
suodroutines. EEnonmmcomtne actuagie-cal|l to a Subroutine, the 
“extern” statement causes the declaration of C subroutine 
ana the designation of the type and number of parameters to 
be passed. The call to the subroutine is done by the "call" 
statement. The mame of the subroutine and the actual 
parameters oassed are included within this statement. 
Provisions were also made to allow the user to assign return 
values from the sudroutines to predefined variables. 

Initial investigation into Robertson's BASIC compiler 
proved that the comoiler has the canability to allow BASIC 
programs to call C Jlanaquaaqe subroutines. Robertson's 
Extended Basic Users Manual should be consulted for further 


details concernina usage. 


2. Testing and Implementation 
Robertson indicated that Extended BASIC could interact 
with suosystems oresently used at the Naval Postgraduate 


Schoc!|] Graphics Laboratory. Implementation of this lanquage 








with the Vector General software was never accomplished by 
Robertson, but the basic feasibility of implementation did 
exist. The first tests attempted in this develooment were 
conducted to determine the correctness of calling C 
subroutines from the BASIC program. Problems arose in the 
passing of floating ooint oarameters. In order for such 
parameters to be passed and aligned correctly within core 
for the C subroutines, the values expected by the C 
subroutines had to be declared as double orecision variables 
within the calling grogram. C language conventions expect 
beth floating Ddoint and double precision variables to be 
Stored in 64 obit fields. By deeclarinag the floating point 
Parameters as double crecision within the “extern” statement 
of BASIC, the crodlem was overcome. Upon the completion of 
successful oarameter passing between Bee JUG and C 
SUubrFoUutinesr continued testina was undertaken to use BASIC 
with the Vector General Library in drawing oictures on the 
Vector General disolay. 

Since development of the Extended Basic compiler and its 
accompanying software, the Graphics Library was physically 
relocated within the UNIX file system. Many of the special 
device libraries were also renamed. The LBAX shell command 
had to be undated to reflect these chanaqes. An undated copy 
of the source and executable versions of the special device 
libraries were olaced on the system for general use. 

In oreparina a BASIC orogram for execution envolving the 
Vector General disolav, differences were noted in the format 


eens and C progrars. The C proaram contained, as its 


Ws) 





frst program statement, an “include” statement. Thorpe 
C11} and Stankowski [10] required this statement to load the 
initilized disolay list in the. proper sequence. The 
position of this statement in the orogram ensured that upon 
compilations the disslay list would be located at the 
beginning of the srocess's data seqment in core space. The 
Start of the display list could be located for refreshing by 
knowing the ovosition of the orocess's data segment. 

The compilation technique mentioned in the preceding 
Paragraoh 1S an imfortant design item in Visco's Vector 
General device drivers usa When desianing the device 
drivers, Visco had to ensure that the start of the display 
list could be easily located. He also wanted to ensure that 
with a snaradle core region, the only segment of the process 
located within this reqion was the data segment. By 
eommeiting a C Vector General orogram with a “"-1i" switch set, 
the file aenerated for execution 1s designated a 411 
filetype. This executable file is distinguished in that the 
text and data segments reside in sepoparate address soace (8). 
Upon execution, the start of the data space is alianed at 
tte becinning of a 32 K word boundary in core. The refresh 
cycle is accomplished by repeated execution of the display 
Pisckeeamychoeqins at this 32 K word boundary. 

Two major problems had to be overcome in order to use 
the Vector General cisolay with a BASIC program that called 
C subroutines. Unlixe C, BASIC made no provisions for. an 
“include” statement. BASIC would have to cause the loading 


of the initialized display list by some other means. A 
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Semearenation of an initilization list could not be appended 
Pomeme Gecginming of the BASIC proaram because of the failure 
of the language to recoanize certain key characters within 
the i Site Such characters as the "e€" or underscore 
character, often used within C variables, are unrecognizable 
and return error conditions. A decision was made to call a 
dummy C sudDroutine which would cause the loading of the 
initialized disolay list in the proper sequence. Such a 
change demanded a nodification of the technique by which the 
Vector General device driver locates the display list data. 
Visco's temoorary drivers nad to be modified to find and 
communicate the offset of the disolay list fromthe 
beginning of the data segment. 

The second major oroblem that was encountered in 
develooment of BASIC was the inability of BASIC programs 
with C subroutine calls to be designated as 411 filetypes 
oom icomoilation. The standard file emitted after a BASIC 
compile was a 407 filetype, text and data being mixed within 


the file. No provisions were made in the LBAX shell command 


A ] a] 


for verelusionm of the “=-1" switch to split imsSteuct ion anc 
Geta space (I & D space ). When the loading phase of the 
shell command was changed to include this opotionr, execution 
of the final executable object module proved unsuccessful. 
As no provisions were made in the comoiler to cause data and 
text instructions to be placed on separate stacks, the 
passing of various OCarameters to C subroutines was unable to 


pe accomolished correctly. It was realized that changina 


the BASIC comoiler to emit the oroper intermediate assembly 


lel 





language code was bdDeyand the scope of the original intent of 
this research. 

A different aooroach was taken in an attempt to overcome 
ehe problem. This approach involved imolementing a newly 
constructed UNIX operating system which used a segmentead- 
process memory manager IM COnjuNction with orcvisions for 


shared core regions. The shared core regions were recently 


installed 1m the hardware. O'Dell) {5] tmolemented such a 
system called SUNIX for the Naval Postgraduate School 
mameuter Laboratory. One version, SSUNIX, was imolemented 


for the POP-1!1/50 processor for use with the graphics 
disolay equioment. Although not operational, this hybrid 
UNIX operating system was planned to be implemented in the 
comouter laboratory. In discussions with O'Dell, SSUNIX was 
@eserived as a solution to BASIC's oroblem of intermixing 
t®xt and data Pestrpucwrons. “ooUNITX could Gistingquish and 
properly execute either the 41il or 407 filetype orocesses 
aithin the shared memory region. The generalization of the 
Vector General device drivers and the oroper interface 
between the drivers and the SSUNIX system would be the final] 
items to reconcile in comoleting the imolementation. 

Through much testing and dedvugging, BASIC was 
implemented as a second high-level programming l|langquage for 
use with the Vector General Graphics Disolay System. 
Portions of SSUNIX had to be modified to effect this goal. 
All documentation for chanaes to SSUNIX and the Vector 
General device drivers are discussed in following sections. 


The use of BASIC as a Vector General programming language 15 
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oresented 1m Aooendi x neo f the Vector Genera] User's 


Reference Manual. 


Ee FORTRAN ITV=PLUS 


ies Background 

Much of the work in attemoting the implementation of FUP 
(FORTRAN IV-Plus) with the Vector General software was 
Srwtar co work saccomoel;ished in the BASIC imolementation. 
FUP ob ve: require several] different techniques ot 
geveloopment. More develooment work is needed before FHP can 
become comoletely Integrated with the Vector General 
software. 

F4UP was developed for the Digital Equipment Corporation 
fe eoy the Commercial Union Leasing Corocoration (CULC) to be 
imolemented under the UNIX ooerating system. The Naval 
Postgraduate School received executable versions of the 
Gomenrer bUt had no access to the source code for it or 
associated software. Hise eassociated softtware included 
files for converting reaular object modules into F4P object 
modules, mies fomec | a6 Wao Ge sob )ect modules into library 
femmat, amd files for linking FSP object modules together 
into an executable object module. DOURGEe ~.eCode and 
documentation were not available during the development time 
frame; this lack of documentation and source for FUP and 
associated routines made it vemyrseay' f1.Cul & to eee ee 
develoo F4P's use of the Vector General software. 


Maes task of imolementing F4P to call C subroutines 





proved to be quite different than that of the BASIC and C 
integration. Such an imolementation will reauire more 
maaearcn gno testing before it is fully accomolished. Two 
important items of imformation were known about FHP and its 
associated software. F4P uses "DEC standard" obmeet 
modules; these are quite different than the C object 
modules. Also,s, prior to user C object modules would have to 
be converted to F4P readable object modules. 

Two software items were available which were advertised 
Bo aollom FSP orocrams to cal) C programming language 
subroutines. The “conv™ command could be used to convert a 
C object module into an FUP readable object module. With 
all current Vector General software written in Cy, separate 
libraries made up of the converted C object modules would 
have to be constructea. The "“callc"™ routine was the second 
item designed to comolete the interface between the F4P 
proaram and the C- subroutine. This routine stacks uo 
Sarameters for C subroutines, executes the external C 


Subroutine, and returns to the calling F4P program. 


Differences Phat did moe exist is the BASIC 
implementation were encountered im the “esa llama vot C 
suoroutines by F4SP programs. All C subroutines had toe be 


separately compiled by the C compiler into object modules 
orior to conversion. The FUP "linker" prohibits 
concatenated sudroutines from being compiled together and 
orocerly linked with the calling F4P object modules. Also, 
as oreviously mentioned, the C subroutine object modules had 


to be converted to FUP readable object modules by the "conv" 
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command. 

The software that would allow the communication between 
F4UP and C subroutines is the "calle" routine. The source 
for this routine is an M11 assembly language routine which 
had to be assemdled by the Macro assembler. This Macro 
assembler 1s one of the executable files which was included 
in the associated software supporting the FUP compiler. The 
Fesulting “callc.obj” and a seldom used “callev.obj” modules 
orovide the user with the facility to place the parameters 
to be passed to the C subroutine in a stack and to jump to 
the C subroutine which is called. The comoletion of the 
suoroutine allows control Go uepeturm toe the. F4P “calling 
Drogran. The Bera leseuun: module would have to be included 
in the link ohase of all the modules in order to obtain-= an 
executable FU4P_ file. An imoortant feature of the "calle" 
routine 1s that it works with oointers to the parameters 
rather than the oarameters themselves. This C oarameter 
representation necessitated changing the C subroutines to 
expect pointers to the parameters instead of the values of 
the oarameters. 

In dealinaq with the requirement for separate compilation 
of subroutines and the call by name parameter passing, a 
separate Vector General library was needed to accomolish tne 
Gaiseee lhe “bibr”™ command would have to be utilized to olace 
the modules ina single library similar to the archive 
command "“"ar™ within the C language. Each Vector General 
Library subroutine had to be updated to reflect the ovassing 


of L-values and then recomoiled. After conversion of the 
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object modules into F4P readable object modules, the modules 
would have to be olaced in a new F4P Vector General] Library. 
The following section will discuss the testing and attempted 
implementation of FU4P as a third language capable of using 


the Vector General software. 


ec. Testing and Implementation 

After general tests were conducted and proved the 
mepelrty Of FP to correctly call C subroutines, testing was 
conducted on a simple F4YP program that would use the newly 
Bomoehucted Vector beneral Library of F4P object modules. 
Two non-fatal errors continued to arise in the testing runs. 
The two C library subroutines, “ecvt" and “fevt", were 
Gescribed as multioly defined in the error listina. Upon 
mpayiew of the source code listings for the two items, it 
became evident that Hour Ov therent assembly lanquage 
mionoutines were involved: "“eecvt", “efevt", "ecvt", "fevt". 
ee eaees mot recognize the “€" or underscore character, but 
rey eer Besic, it disregards the symbol entirely. Through 
continued testing, the none=distinction between the two 
Ssimtlar oairs of subroutine names was found to be no 
detriment to orogram loading and execution. Correction or 
this orodlem would recuire rewriting the C subroutine calls. 

A second error of some sianificance was found while 
testing oroceeded. wecor ane to C programming language 
documentation (7), C allows a user to assign ae floating 
point value to an integer variable. Such an assignment 


performs truncation towards zero on the floatina point value 
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and assigns the whole number value to the integer variable. 
An inconsistency was found in the methods that C and F4P use 
imetne trtimcation cof floating pcint numbers. 

The converting command “conv” was found to change this 
basic coding seauence to a sequence which placed the 
truncated floating point value into a lonq integer with a 
Memagth of 52 bits. Such a change would, in effect, cause 
only the uover 16 bits of information to be used. To remedy 
the situation, witheut being able to ohysically update the 
source code of the convert routine, all instances of such an 
operation would have to be located and corrected within the 
C subroutine. Fach instance was changed to reflect that the 
integer variable was a temoorary long integer variable. 
This was immediately followed by the long inteaer variable 
being ‘assigned {Gao bit tnatecer. The change was proven 
Mmrecryve GhO was instituted in the F&P Vector Genera! 
Library for the "“vagabscale", "vgrelscale", and "vapscal" 
routines. 

After continued testing, one final, fatal problem was 
discovered with the interaction between the F4P and the 
Vector General! software. When Vector General subroutines 
are converted into F4P readable object modules, certain 
Switches are set by default. These switches govern the 
overlay use in the "linker" phase ana the global recognition 
of different seaments which are changed to "psects". 1 
oecomes oossible for more than one cooy of global variables 
to exist. In checking the display list located in core, two 


separate disolay lists were found to exist, each containing 
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merrormatvon not held by the other. Information necessary 
for refreshing the disolay Jist was inaccessable to the 
device drivers. In short, one complete updated disolay list 
ava met exist. 

The inability to implement F4P as the third language 
capable of utilizina the Vector General Graphics Display 
System was not the result of any one item. The lack of 
Seoerces code for the softwares, poor documentation on F4P 
accomoanying software, and inherent differences in the 
structure of CC and FUP were all contributing factors. The 
implementation of FUP in the Vector General environment 
should oe possible by obtaining orooer documentation. The 
final hurdle to overcome would be the problem of multiple 
copies of the disolay list. Recommendations for future work 
in tnis area will be made in the final chapter of this 


thesis. 
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TV. GRAPHICS SOFTWARE 


Modifications and enhancements to grapnhics software fa) 
within three Categories: external device interfacing, 
display list supportina software, and general] system 


imorovements. 


Seo eweRNAL DEVICE INTERFACING 


The external devices may be used to programatically 
eont co] the disolay presentation. Alohanumeric, analog, 
logicals positionings and lightoen data may be returned to 


the user's program throuch the graohics routines. 


1. Keyboard 

Alohanumeric data entry 318 accomolished through the 
Vector General keyboard. Depression of any key enters an 8 
bit ASCII character code into the keyboard register and sets 
the oriority interruot request indicating a character has 
been entered. Upon executing the interrupt handler, the 
Smareacter code is placed ina keyboard buffer to await a 
Gam? from th@ user's proaram. The "caet" routine was 
desiqned to return the data entered from the keyboard. The 
“caet” routine buffers the data until a carriage return is 
received, whereupon the entire alohanumeric string is made 
available to the user's program. The ouffering of input 


data was desianed to allow erasing of erroneous data. As no 
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data 1S available to the user's program prior to a carriage 
return, incorrectly entered data may be removed by repeated 
controlea keystrokes. 

The "cget"™ routine solved the requirement for returning 
alphanumeric data strinas 2 fe) the user's program. 
Determination of integer and floating point numbers, 
however, oresented an additional problem. Recognition of 
integer or floating psoint numbers from a character string 
requires the conversion of ASCII data to numerical data. 
The svstem-resident C library contained two routines, “geti" 
and "getf"*, which accomolish the desired ASCII to integer or 
float conversions. Use of the system routines was judged 
more desirable than inventing new software. 


¥ 


Two new routines, “fcet" and “iget", were written which 
set condition flags and oass control to the system “getf" 
fae Gget?r routimes to accomeolish the conversions. A new 
"getchar™ routine was written to replace the system=resident 
"getchar"™ routine. Ucon executing either the "“getf" or 
"geti" routine, a call is made to the new "“getchar" routine 
to obtain a character. Normally, the default input device 
would be interrogated for the desired character. However, 
due to the condition flag set in the orevious execution of 
the Gioet ors 1qet" foutines, the “getchar” froutine 
requests the character from the Vector General keyboard. 
Repeated calls to "“getchar" are made by the system "“qeti" 
fag gett coutimes umtil a carriage return iS received. 
The routine determnines the integer or floating point number 


waenas within its ASCII string and returns that number to 
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mmercalling routine, The result is that the user is able to 
oetain integer or floating point numbers from either the 
console or Vector General keyboard without an excessive 


amount of additional software. 


Eee rkuUnction Switches 

Ite Se lighted fumetiom switches orovide for logical 
true/false information to be available to the user's 
aroaqram. Three routines were added to enhance the use of 
the function switches. The "fsman" routine was desianed to 
return the status of the desired function switch. i 
physically deoressed, a logical value of true or one (1) jis 
returned to the user. .If not deoressed, a logical value of 
Meapesew or zero (0) 1s returned. 

The “lamo"™ routine was desianed to light or extinguish 
the lamo of the desired function switch. No deoendence on 
the status of the function switch a5 inherent in the 
Seeration of the “lamo”" routine. fhe routine can be used to 
more 2 fumMetion Switch to indicate that a certain condition 
nas been attained. 

The “fstoq™ routine was designed to further extend the 
SGese im utilizing the function switches. The wef stog 
routine creates the illusion the function switches are 
toqaglies which flio-flop their logical value as well as their 


lamo status with each cepression of the Switch. 
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oer «Comtrol “Dials 

Analog information is made available to the user through 
timer use of the 10 contro! dials. Integer values returned 
from the control dials vary from =2048 to 2047, the maximum 
obtainable from the le bit system register. Floating point 
values returned to the user through the dial routine, 
however, vary from 71.0 to 1.0. This range can be easily 
extended within the user's program. Analog values obtained 
through the dial routine are useful for adjusting other 
porogram variables such as rotation rates and translation 


SsOeeds. 


4, Trackbal | 

Previously mentioned devices have no connection with 
ahat the user iS orimarily interested in, the display 
Screen. The trackball is an external device designed to 
provide visual oositioning feedback to the user of data on 
the display screen. This visual feedback 1$ obtained by the 
acpearance oof a small, blinking cursor on the display 
Screen. Movement of the user's hand across the round, 
olastic trackoal | causes the software-generated cursor to 
move in an aopropriate manner. 

The disolay of the trackball cursor is accomplished in a 
manner similar to other elements. A sequence of commands is 
executed by the disolay controller which draws a smal! cross 
at the origin of the X#Y axis. Each refresh cycle the 
trackball's X and Y coordinate registers are updated and 


used to modify the coordinate axis of. the <ursor. The 
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cursor 1S moved reflecting any user movement. of the 
tage xbpal | . To insure cursor disolay, all cursor generating 
code 1s inserted in the disolay list prior to the code (for 
any other element. 

Two routines were designed to be used with the trackbal} 
moc: lities. The "cursor™ routine was designed to activate 
or deactivate the display of the trackball] Cursor. 
estion 1S accomolished by ensuring that the display 
controller executes the cursor drawing code. Deactivation 
1S accomplished by the disnolay controller skipping the 
cursor generating code within the disolay list. The “posit"™ 
routine was designed to return to the user's porogram the 
Beemturon of the cursor on the disolay screen. The "posit" 
gomwtrme meturns a floating point value of the cursor's 
position within the defined coordinate system and 1s not 


aeoendent on the active disolay of the trackball cursor. 


Bee Joys 1c k 

The joystick 18 an external device similar to. the 
meaex<pall in that it erovides visual positioning feedback to 
the user. Unlike the trackball, the joystick apoears to 
move threew-dimensionally. Movement along the 2Z axis 18S 
geeomo!lished by variance in the intensity level of the 
blinking joystick cursor. As the user twists the joystick 
knob to move the cursor further back into the display 
screen, the intensity level of the cursor display 1s reduced 
giving the apoearance that it is fading into the distance. 


Joystick cursor generatina commands are inserted and 
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uodated in the display list just like the trackball] cursor 
commands. Seti t VemmEECUICSOr = amd "posit Saseroutines work 
pem@ably well for the joystick with the addition that a 2Z 
Gimension is available for the joystick "posit" routine. 
Both the trackball and joystick cursors are useful Tae 
providing the user with visual feedback to interactively 


position display elements. 


Ove Lightoen 
Ahile the trackball, joystick, and associated cursors 
Brovige positioning informations the lightrpen is unique in 


mes ao1i1ty tor oointing or identifying a portion of the 


disolay. The lightcen does not write on the screen, but 
senses light from the disolay on et Gumeonagt OC ee.) Is Not all 
elements drawn Om stme dirsolay screen cause tltightpen 


Meee rruGts. An element's lightoen enable bit mur be set 
meene the |Iqhtpem” routine or no Jightoen interruoct will 
occur. Once the enadle bit iS set ana the operator 1s 
pointing the lightoen at a portion of the element, the 
emsoolay controller causes the lightoen interrupt to occur, 
The objective of the lightpen interrupt handler 1s to 
determine what portion of the display caused the interruct. 
After aopropriate action is taken, the processor is allowed 
to continue what iSeawasmexecutinag Orlor, to che: interruot. 
To determine what element caused the interrupt each element 
is given an element number. This element number 1s loaded 
maeeeemreaist@r just orior to the actual drawing of the 


Piement. Upon encountering a liahtpen interrupt, the 
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interrupt handler interrogates the element number register 
to determine the element causing the interrupt. Each 
element has a lightoen flag associated with ltaeewithim the 
data structures. Upon determining the element which caused 
the interruot the interrupt handler sets the appropriate 
flag and releases the processor to continue what it was 
Seaigg orior to the interrupt. The interrupt handler was 
Kept as simple as possible to minimize the amount of time 
the processor must spoend on interruots. 

Two New routines were designed to help suoport the 
ivonteen facilities. The “penhit"™ routine was designed to 
return to the user a logical true/false reoly. This reoly 
was 1M answer to whether a particular element or object had 
generated a lightpen hit. The routine determines which 
element or object is in question, checks the aporopriate 
element lightoen flag, and returns the results to the user. 
The routine was made general enough that it could check for 
a liahtpen hit on an individual element, an object, or the 
epraiene ipictures® 

The "“clrhit”™ routine was desianed to clear individual, 
grouos, or all elements of orevious lightoen strikes. The 
routine resets lignhtpen flags to the clear position in 
oreoaration for identifying new lightoen strikes. 

Although the caoabilities of the lightpen make it an 
ideal device for pointing or identifying portions of the 
disolay, the inclusion of additional software made the 
lightpen an eaually good oositioning device. By tncluding 


additional draw commands in the disolay lise in the same 
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area as the commands for the trackball and joystick cursors, 
a lightpen cursor was made available to the user. The 
lightpen cursor iS an octogon=shaped object which may be 
moved with the helo of the lightoen. The iightpen cursor 
was constructed with eight elements comprising the eight 
sides of the cursor. Upon aporoaching the lightpen cursor 
with the lightpen, the cursor appears to latch on and follow 
the lightoen about the display screen. 

The trackina of the lightoen cursor is accomplished by 
agetermining which side of the lightpen cursor first 
inittiates a lightoen hit. Moving of the coordinate axis of 
the cursor 1S tnen accomolished, minimizing the distance 
between the center of the cursor and the lightpen. The 
determination of the side initiating the lightpen strike is 
Meeomolisned within the interruot handler. Distinction 
between the sides of the lightpen cursor and other lightpen 
nookable elements 1S accomolished by providing the lightoen 
curser wath 6 unique element numbers. 

As with the trackball and joystick, two routines provide 
lightoen cursor ovoo0sitioning information to the user. Thre 
"cursor" routine is essential in activating and deactivatina 
the display of the lightoen cursor. Unlike the trackball 
and joystick cursors, the lightoen cursor must be displayed 
Bor Oe wodated. The “oosit” coweine fFeturns the floating 
DO0Iint position of the jiightpen cursor within the defined 


coordinate system. 
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See DU LOPLAY LIST SUPPORTING SOFTWARE 


In reviewing, revisina, and extending existing software, 
many tests and changes were required, Tres "are" and 
“circle” routines were rewritten to provide for correct 
manipulation of associated center and endpoint arguments. 
The "setvector” and "endele" routines were revised to ensure 
Bmoper termination of display list element blocks and to 
correct deficiencies in the generation of auto~tincrement 
meas and circles. The “intscale”" routine was revised and 
extendedqd to allow the user to specify whether intensity 
eutoff plane orovisions were to be in effect. Changes to 
other routines included additional software to inhibit error 
conditions, and correlating routines to oroviae optimal use 
of available display J]1ist space. Three routines received 


Sarmtrcular attention and require a fuller explanation. 


few Remove Routine 

As oriainally designed the Qrapohic system data 
structures provide for a display list of a fixed length in 
Size. Should all the display list be utilized, No 
additional data would be displayed. For examole, should the 
faeeeceme lemient of the first object the user builds use up the 
entire disolay list,» no additional elements could 0obe 
displayed even though only one element of one object had 
been used. Nemmally sueh a sitWUation would not occur; 
however, snould numerous large elements be constructed this 
Same problem, lack of available display list space, could 


arise. The “remove” routine was designed to help solve the 
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oroblem. The user specifies those elements no longer 
essential to the dtsolay which can be eliminatedr thereby 
creating available space within the display list for 
additional elements. 

A somewhat analogous situation occurs within the memory 
management techniques of most operating systems. Various 


methods have been devised to recover available memory 


segments and reduce fraamentation. The importance of 
recovering unused or fragmented memory space in memory 
management techniaues Cannot be overemohasized. The 


efficiency of the entire system may depend on the judicious 
use of available memory. As the importance of recovering 
available disolay list soace for a process already running 
in memory 1S Somewhat lower than for memory management 
techniques, a less soohisticated method was designed for the 
"remove™ routine. 

Uoon receiving a list of nonessential elements from the 
user, the "remove" routine sequentially processes the 
removal of each block of element commands. The freed biock 
is buroed or bubbled through the disolay list by movina 
Succeeding element blecks uo within the display Jist. The 
movement of element blocks within the disolay list requires 
the adjustment of address oointers to these element blocks 
ro ensure oroper ovoeration of the disolaye As the location 
of active element blocks are moved to free unused memory 
locations, disolay list refreshing is inhibited during this 
operation. This procedure, though costly in execution time 


for a series of elements, was deemed more suitadle than a 
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more sophisticated method which would have cost the user 
additional memory soace. Additionally, this simple 
technique was preferred because the “remove"™ routine was not 
expected to be used so frequently within a program that a 


momentary delay in execution would be noticed. 


e- Printv Routine 


As criginally implemented, the graphics software 
provided for. only one tyoe of element Contata na 
SrOnamumeric datae The "“charele" routine was used to 


Beecify the contents of Piewmemaracter String whilenmcoul.e 
contain any of the characters available in the Vector 
General character set plus a few format instruction codes. 
Provisions fer chanmagina the contents of an element's 
character string were nonexistent. 

A search was conducted to determine the most feasible 
way of providing for an element which could handle changing 
character strings and also provide expanded formattina 
cacabilities. The success of the “fget" and "“iget”™ routines 
in using system routines focussed attention on the system 
aaimimtt  coutine. The "printf" routine converts, formats, 
and orints its carameters after the first arguments under 
eont ro] Gtem tne “first “arqument.« The first araqument, the 
format argument, consists of characters and conversion 
Smeci fications. It was felt that a combination of the 
“charele” and "printf" routines could exoand the use of 


character strings used within the Vector General Display 
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System. 

In accomplishing the merger of the ‘on aenet and 
"charele"™ routines two new routines were written. The 
"orintv”™ routine contains arguments from both the "“charele" 
aaa printf” routines. Positiomyngq and character string 
initialization arguments are similar to those in "“charele” 
while format and conversion arquments are similar to the 
memryntft” routine. The “printv”"” routine oasses its format 
and conversion arguments to the system "printf" routine to 
accomplish the actual convertina and formatting of the ASCII 
character string. As the "printf" routine must call the 
System "“outchar" routine to output characters, a newly 
designed "onutchar™ routine was substituted for the system 
Mesrvdent routine to outeut characters to both the console 
and Vector General disolay screen. 

The “printv”™ routine aives the user a greatly expanded 
eaeaebi lity im handlina character strinas. Althougn tne 
"orintv”™ element requires additional display 11st space over 
that of a "charele" element, the exoanded formatting and 


conversion caoabilities of the "orintv" elements in addition 
to its ability to ove used reveatediv for different character 
strings, makes it a highly useful enhancement to the display 


Inst SucDOrting software. 


ie Disolay Routine 
As mentioned oreviouslys» an elementerobject link must be 
estaolished to disolay elements on the screen. While ooth 


the “remove”™ and "erase" routines caused the disappearance 
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Siege clement from the display screen; no routine was 
available to activate or deactivate the aisplay of an 
element without affecting the elementerobject association. 
The “display” routine was desianed to accomplish such a 
ourpose. By reolacing certain graphic commands within the 
disolay list with subroutine return commands, the display 
controller may be made to skio execution of an element's 
draw commands. This effectively deactivates the display of 
the element without afftectumed the elementrobject 
associations. Activation Ojai the element is then 
mecamolishned by reinserting the original commands in the 
display list such that the disolay controller executes the 
element's draw commancs on the next refresh cycle. The 
"disoplay”™ routine allows the user to turn an element's 
mmapiray on of off without affecting the necessary element=- 
object associations. Thus the number of routines required 
to activate or deactivate an element's display is less than 


if either the “remove” or "erase” routine had been called. 


C. GENERAL SYSTEM IMPROVEMENTS 


Many of the revisions and extensions to system software 
oreviously mentioned could equally qualify as general system 
imorovements as their oresence ensures a Smoother interface 
between taeluser amd the disolay controller. Of particular 
comceern in this category are the areas or system 


initialization and error diagnostics. 
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Mme oystem Imitialization 

The “sysinit”™ routine is the first Grigpnicsseroutine 
called within a user's program. The routine was designed to 
establish links from tne user's process to the Vector 
General display unit so that refresh data could be sent to 
the display unit and external device information could be 
returned to the user. The presence of two Vector General 
display units required differentiation between units. The 
user scecifies the desired disolay unit with the argument 
Bess@d to the "“sysinit”™ routine. To insure maximum 
epportunity for execution of a user's program, software was 
addea that attempts to link a user with the secondary 
SaesObay Unit should the system be unable to link to the 
user's orimary choice. The user's orocess 1S terminated 
only when the system has failed in attempts to link the user 


meee OOth Gisolay units. 


Ee Error Diagnostics 

Recognizing that users will make errors, tne design and 
implementation of error detection and recovery facilities 
was icentified as a necessary expense. The price paid for 
aecor detection and diaanostics depends uDON rhe 
sophistication desired. The PL/C compiler is an example of 
extremely forgiving and diagnostically heloful software. 
Recognizing that such a system is not cheap in terms of 
required Spoor t img software, the requirements for a 


reasonaocle system of error diagnostics were reviewed. 


mte was felt that al) detected errors should be 
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identified to the user. Presentation of error  diaqnostics, 
howeverrs, iS aS important as the actual error detection. 
Cryptic error messaqes with numbers which must be looked up 
in manuals, do little to help the user diagnose problems. 
Concise error messages which identify the error, the routine 
where 1t occurred, olus aive reference to additional 
information were deemed more suitable and could be obtained 
with minimal overhead. 

The error diagnostic routine was rewritten to provide 
ames user with four items upon error detection. An*@rror 
tyoe 1s specified so the user may realize what has caused 
meme error. Additionally, the argument in error and the 
routine 1n which it occurred are specified to ensure that 
the user odinpoints the problem. Should the oreceding 
information de insufficient, the last item orovided 1S) an 
error nmumder with which the user may odtain a detailed 
explanation of the error from the Vector General User's 
Reference Manual. 

Graceful error recovery could be considered an art. 


's orogram uron Vit wae! error 


i eimmination of a user 
detection, while easily accomolishable, would tend to not 
only deflate egos but also discourage potential users. All 
software routines were desiaqned and implemented to detect, 
maemtifty. and "oracetully recover from user errors. 
MilitHouGh the detection and identification of errors 18s 
fair | y Stamncera throughout the routines, the recovery 


methods vary from routine to routine. Within some routines, 


default parameters are aSSumed upon error detection to 
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ensure continuation of the routine. Other instances may 
occurr however, where no default parameter could be assumed. 
In such instances the only form of recovery is to exit the 
routine and return control to the user's program. With the 
exception of the "“sysinit™ routines, no routine will cause 
termination of the user's orogram. This was done to ensure 
that some pvpart of the user's display 1s presenteds providing 
the user some amount of selfeconfidence and a starting ooint 
Mopeusimag the error diaqnostics to DiNnpOInt remaining errors 


iomcme orogram. 
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Ve. MODIFICATIONS TO SSUNIX SYSTEM SOFTWARE 


A. GENERAL 


Investigation was begun into the develooment of SSUNIX 
to further generalize the use of other languages with the 
Vector General Graphics Disolay System. As a result of the 
Extended BASIC compiler's inability to separate the 
instruction and data seqments of an executable file, SSUNIX 
was implemented on the PDP#11/50 A processor within the 
Comouter Laboratory. After studying the UNIX and SSUNIX 
Systems and reviewing OQO'Dell's recommendations for final 
integration with the Vector General softwarer modifications 
were mace to complete the  imolementation. Further 
modifications were mace when oroblems arose 1m the SSUNIX 
system of core allocation. The modifications made to SSUNIX 
software were in two general] areas of the system software. 
Modifications were made to the SSUNIX source code and to the 
Vector General device driver code. 

O'Dell} CoH implemented a segmented=process memory 
management version of the UNIX operating system which was 
previously develooed cy Emery [3]. O'Dell also implemented 
an additional version, SSUNIX, which was designed for a 
shared memory environment. The UNIX ooerating system (6), 
from which the above modified systems were constructedr 1S a 


time-sharing system developed at S8el!] Laboratories. The 
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UNIX system was currently in operation at the Naval 
Postgraduate School Comouter Laboratory on the PDP-11/50 
merocessors. The notable accomplishment of the SSUNIX 
operating system is that it alians a process's cata segment 
or combined data and test segments into a region of shared, 
Gual-ported memory. The orocess image is then locked in 


this memory region for execution. 


palogmmro O' Dell's sccomoltshments, Visco [15] had 
sugaested that Emery's original design was a oromisinga 
technique for allocating a Vector General orocess's data 
seament Into a shared memory region. This dual-ported 


memory region could sunsequently be accessable by ae slave 
processor which would continuously access the disolay list 
data by DMA (Direct Memory Access). Visco's slave processor 
design would alleviate the PDP=-11/50 bus tiesup croblem 
which was caused by the high interruot precedence of a 
refresh cycle. The accessability of the shared memory 
region by the main orccessor would orovide the realw=time 
requirements for multiprogqramming in the refresh graphics 
environment. Visco believed that by ensuring only data 
segments would be located in the 32 K word shared core 
region there would be greater efficiency and less likelthood 
Shee ving procrams too large for execution. 

A xey factor for the imolementation of SSUNIX was its 
oropensity to distinguish between processes where cata and 
text were separated segments in core (411 filetypes) and 
files wnere data and text were mixed (407 filetypes). 


SSUNIX causes both filetypes to be loaded enero. the shared 
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memory 


solution to 


object module where test and data reside together. 


beyond 


that other user 


PeEQIOon and executed alike. 


the 


BASIC's problems, 


SSUNIX proved to be the 


Oroblem of executing the BASIC executable 


Looking 


SSUNIX is of such a general nature 


languages can be more easily implemented 


with the Vector General software. The future integration of 
mee with the SSUNIX System Sivouw ld require no further 
moatications to SSUNIX. 
B. MODIFICATIONS TO SSUNIX SYSTEM CODE 

Modifications to SSUNIX were made in two genera} areas: 
the interface code between the user and the system software, 


amet ne correction of 


to ere! ale 


changes were tested and 
The nature and exolanations for the changes are discussed 


the following paragraohs 


SneMpROcesSsetor al beocating core - “oricer 
the process yn tre snarec Core region. These 
instituted in the SSUN{X system. 


in 


limmatnS See t 1 OM. 


The first modification to SSUNIX was the updating of the 


shared memory 


Subroutine of the system. 


eaat a Shared 


Mrecumion of a orocess. 


System 1s the 


These regions of shared core are 


numbers 0 
Emiemeolock of 


Region 0 


region parameters located within the "main" 
SSUNIX is alerted by "“getshr" 
memory reaion of core is requested for 


The first oarameter passed to the 


region of shared core that 1S requested. 
assigned the Vdaent ity ine 

cooecr suc 08 = 000) sang. (olioeks 5000 -.6000). 
core reoresents 64 bytes of core space. 

is 32 K woras in size while region 1! is 16 K words 
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Vee srze « Region 0 was originally declared as 1000 blocks in 
wenaqtere "Seqginning at block 3000. ines Weenko ret Mcma 1 rst 
region had to be corrected in SSUNIX's “main” routine. The 
commen size of the ™reaion is 2000 blocks in length beginning 
memecrock 2000. 

The second modification to the assembly lanquage code of 
"getshr"™ was the addition of a ocarameter to be passed to the 
system. The parameter oassed is the address of the first 
word of the disolay list. The address represents the offset 
vemeumie of the first word of the display list from the 
beginnina of the data segment. If the text and data 
segments are not solit, the offset is from the beginning of 
ome mixed text and data. This method identifies the first 
word of the disolay list to the device driver whether or not 
text and data were solit. If I & D space were split and 
Vegata was imeluded at the beqinning of the C program, the 
offset would be zero indicating that the disolay list starts 
at the beaqinnina of the process's data space. If, as in a 
BASIC process, I & D space were not solit the offset would 
Gee aodggec with the offset of the Bate Segment from thre 
beginning of the shared memory region. 

pEveom me the imelusion of the offset address in tne 
"“aqetshr" routine, both "“getshr”™ and "“freeshr”™ had to be 
introduced into the Vector General Library. The previous 
calls to "“rtime" and "nonrtime”™ under the UNIX system were 
Sbemeea to “getshr” and “freeshr” calls. The difference was 
faa t the shared memory confiaquration of core required the 


Vector General orocesses to request this shared core region 
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Mole Ooagai ng and execution. 

In order to use the offset value oassed to the system by 
eae 6oetshr” call, a small routine called "“vgdsoff" was 
see@eag sto SSUNIX. When "@Qetshr” is called by the Vector 
General user code, a new variable "firstwdaddr" is assigned 
momeesvalue of the the offset of the first word of the display 
ies t . The "Yagisot f™ routine returns the value. of 
mammatwaacddr” sto a calling rowtine in the device driver. 
hae —enly routine that would call for this value would be 
eyodevoO0.c"™ which is the POP=11/50 device driver for the 
Yector General Disolay Processor. Jhis offset value passed 
to the driver code is a key factor in allowing various user 
languages atstise the Vector General software. Without this 
offset, the adility to generalize the refresh method (for 
different lanquages would be difficult. 

The final modification to the SSUNIX system was the 
Gest of a condition that had previously gone unnoticed. 
Menthe helo of O’Dell, the source of an error in core 
Baerocat ion by SSUNIX was traced to a routine called 
Meoeloc™. %IHis routine allocates soace in core to the 
process being loaded by first checking the core "free map". 
fiemufeee map, which 1S a mapping of free core areas, keeps 
track of the areas of core which are free to be used for 
storage of a process. SSUNIX first Swaps a Process out of 
core onto disk. The orocess iS then copied back into core 
in an area not within the shared memory region so it 1S out 
of its own wav. "“"Malloc” failed to take into account that a 


large free core area could exist from just below the upoer 
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address of the shared memory reaion to the too of available 
core area. If the area beneath the shared core region was 


not larae enough to store the process, the next free area to 


be checked would pe this large area. This area was 
unavailable for storage as the set flag "“sharflg" indicated 
the region was itm the shared memory region. As the 


beginning of the area was located in the shared core region, 
the entire area was marked unavailable for process swapping. 

A routine called "spnlitmano"” was designed and imolemented 
to remedy the oroblem by updating the core "free map” to 
reflect that the regiecn above the upper boundary of the 
shared core was available for storage. "“Splitmap” is called 
iaeeeme Shalloc” routine just prior to a call to "“ceswap". 
Beeswam originally called the “malloc” routine to assign 
the core area for temoorary storaae. "Splitmapo” changes the 
@eemesentation of the free core region to two free core 
regions which would be seoarated by the upper boundary of 
moe Shared core region. The area within the shared core 
region would not be used due to the set "“Sharflg", while the 
area above the boundary would be oroperly allocated. 

Otner core allocation conditions were reviewed to 
Getermine if additional oproodlems could arise. No other 
problems were noted, and the updated version of SSUNIX was 


pouma to function properly. 
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C. MODIFICATIONS TO DEVICE DRIVER CODE 


As previously mentioned, the device driver code for the 
Vector General was modified to allow the execution of 
processes with or without split text and data segments. 
Visco designed the original device drivers, "nvgdev34.c" and 
“nvadev50.c", to support the Vector General in a multi= 
emocessor mode of operation. The two processors were to 
interact in refreshing and updatina the Vector General 
disolay is G Inherent in the design was the assumption 
that all processes would be of the 411 filetype, where text 
and data segments are seoarated. The data segment would be 
located alone in the sharable core region. In order to 
discuss the modifications to the drivers, a brief 
Seseription of each driver is eresented. 

The "nvgdev34.c" driver is the provoosed POP=-11/34 
resident device driver for the Vector General. It 
communicates to the PDP=11/50 by messages that are passed 
throuan a hardware interface device called the DRw-11°K. The 
driver is passed several items of important information by 
the message orocess: the offset of D0 space within the shared 
memory; the use of Vector General numbers 0 or tr ands, the 
time to begin refreshing the display list. This driver is 
also responsible for handling the interrupts generated by 
the Vector General display controller. 

Mee weivadevSOsc™ driver is the PDP=11/50 processor 
resident device driver that supports the Vector General in 


the two orocessor MOCGC e This driver formats and sends 
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messages to the POP=-11/34 processor through the OR=-11-K 
device. The messages sent by this driver designate the 
offset of the data space from the beginning of the 32 K word 
shared memory region to determine where the disolay list 
@egins in core. 

The temoorary device drivers, "tvgdev34.c" and 
"tvgdev50.c", were designed to support the Vector General in 
a sinale processor mode. The two drivers were originally 
written by Visco to simulate and test the operation of the 
two orocessor design until the POP=11/34 orocessor could be 
installed. Both tempory device drivers will continue to 
drive the Vector General until the slave processor is 
integrated into the system. 

The drivers were cesigqned with two goals in mind. The 
merst GOa! has been discussed before. fhe PDP=11/34 driver, 
as the refresh processor, would refresh the display Tlist. 
The second design goal was that the PDP-11/50 driver had to 
inform the slave orocessor of the location of the disolay 
ers t for refreshing ourpcses. lm generalizing the driver 
code these two goals remained oreeminent. The following 
Saragraphs document the exact modifications made to tne 
device drivers currently used under the SSUNIX operating 


system. 


¥. Modifications to ITVGDEVS0.C 


Only one addition was made to this driver. Within the 
"ygooen" routine, a check was made to determine if I & D 
soace was solit. Iteeiseetwas aot split, imadiveatina - a 407 
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process, a message was sent to the 34 device driver which 
passed the offset of the first word of the display list from 
the beginning of the process. The message was distinguished 
in the 34 driver from other messages by virtue of its sian 
bit being set. The messaqe was constructed by setting the 
sign bit for the value returned from the previously 
developed "“"vgdsoff" routine within SSUNIX, A return to the 
59 driver was made after the message was processed by the 34 
eriver. The use of the messaqes in the 34 driver wil be 


GSaseussed wn the following section. 


eee odifications to TVGDEV34.C 

The functioning of the 34 device driver depends on the 
information passed to it by the 50 device driver. Several 
modifications had to be made to the driver to generalize the 
code for additional lanquage imolementation. The first 
modification was the crocessing of the offset message passed 
by the 50 driver in cases where [ 3 D soace was not split. 


This message is received by the UVES AC Om! - routine and is 


converted to a positive value. A new variable, 
"sharnemoff", is set to the oassed value. The value of 
“sharmemo ff" remains zero i f a ail process is executed 


because the variable had oreviously been initialized as zero 
and no acdcditional messaqe would have been passeo to the 
driver. If the variable had a oositive value, indicating a 
497 porocess, the item would be used in the “vaopen"” routine 
Weretotea within the driver code. Three separate variabdles 


deoend on this variable for determinina values that tne 
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refresh cycle and the PDP=-11/34 memory management operation 
are vased on. 

Whe PDP=11734 is unabte to address items in a user's 
disolay list by simoly referencing symbol names. It is able 
Po eoceress only the 32 K words of the dualsoorted shared 
memorye By using the memory management hardware and the 
message information passed by the 50 driver, the correct 
physical addresses of the display Jist items can be located 
feareecore. The page address registers, when properly” set, 
allow this maoping or conversion of virtual to physical 
addresses in core (1). 


Three variables called “vapar", "vgreal", and Sp mean 


involve the use of memory nanagement. The "oo" variable is 
a virtual address pointer that can be used in addressing any 
item in the display list which resides in the shared memory 
region of core. This variable can be used to address up to 
4 K words of core which is more than adequate for addressing 
the several hundred words in the display list pbet miaht be 
accressed. 

The result of the modifications made to this device 
Griver was the correct refreshing of both 407 and 411 
filetyoe processes. Al Soother adag@a items within this 


eriver reflect additional interrupt handling capabilities 


for the external devices of the system. 
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VI. CONCLUSTONS AND RECOMMENDATIONS 


The primary objective of work described in this thesis 
was the implementation of enhanced user software with the 
Vector General Display System. This objective was attacked 
on two fronts. The first anproach was to test, correct, and 
expand the software creviously available on the system, 
which would improve user interaction. The second approach 
was to implement other user lanquages, specifically versions 
of S3ASIC and FORTRAN, with the Vector General software. 
Together, the two aporoaches provided the successful 
imolementation of a oackage which better supports user 
interaction with the Vector General Display System. This 
chacter orovides further recommendations to improve the 
System in the areas of the display list design, language 


develooment, and system software imolementation. 


Me DISPLAY LIST DESIGN 


In the present desian of the Vector General software, a 
Structure within the display list is utilized to store user 
commands to be executed on the Vector General display. This 
Structure “vodlbuf" is of a fixed lenaqth, 4 K words of the 
shared memory. An improvement in this technique of having a 
fixed length display list could be investigated. One 


possibility would be the imolementation of software to 
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increase the size of the structure which would utilize the 
unused portion of the sharable memory region. This software 
implementation would be useful when no other oprocess needs 
the shared memory region and the parent process requires 


Be@itiona! coré space. 


B. LANGUAGE DEVELOPMENT 


FOP (FORTRAN IV-Plus) was not completely imolemented 
with the Vector General software due to problems encountered 
with the interaction between the F4P and C lanquages. It 185 
recommended that Investigation continue in reconcilina the 
“overlay” oroblem caused by C converted subroutines having 
more than one copy of alobally declared variables. 
wrerequisite to understanding this problem 1s the 
acquisition of source code and documentation for the F4P 
Somower, the “Conv” subroutine, and the FSP “linker". 
Memoretion of the the F4P and C interface would further 
expand the utilization of the Vector General Graphics System 
to users with knowledae of other languaaqaes. 

The inability of Robertson's BASIC comoiler to split I & 
D space is viewed as a less important problem. SSUNIX and 
Griver desian modifications were inolemented to overcome 
execution proolems of the BASIC Vector General orograms. 
The expense of BASIC'sS inability to solit text and data 
segments required ene. allotment of more shared nemory 1n 
loading the combined text and data segment. By reworking 


the compiler to allow the stacking of data and text in 
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seoarate data and text seqments, more complex BASIC orograms 
could be executed in the shared core reaqion allotted for 
execution. Additional testina of large BASIC programs could 
help determine the limitations of loading both text and data 


segments into the shared memory region. 


Gee SYSTEM SOFTWARE IMPLEMENTATION 


An increasing item of importance to the software 
develoced in this thesis and orevious software work is the 
Gontinuing suoport of the SSUNIX onerating system in the 
Naval Bosuaraduate Seneol Graphics Laboratory. Ito is 
recommended that increasing emohasis and testina be placed 
on Sow x while running in a dayrtor-day operational 
environment to ensure its reliability. 

The implementation of the POP-11/34 processor in a 
auele-orocessor “mode with the POP=11/50 orocessor should be 
of crimary importance for the Vector General Display System 
to alleviate the Gui tf ent bus tiewup oeroblem, An 
investigation into the communication requirements between 
the slave and the master processors should be conducted. 
The hardware interfaces for the 32K word shared core region 
and the Vector General display device should also be 


imolenented. 
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APPENDIX A 


Voth so REPERENGE eMANU AL 


The ouroose of this document is to orovide the user with 
the information necessary to execute proaqrams employina the 
Vector General qraphics disolay. This manual was originally 
preoared by 8. J. Stankowski in June 1976 and revised by N. 
Mev artino and D. C. Endicott in December 1977. 

Section I provides a brief introduction to the Vector 
General disolay system, the software support librarys and 
Bmemorerequisites for their effective utilization. [ee eon 
Il descrioves the Vector General system 1n more detail, 
expanding uocon the hardware featuress System interface, and 
external device Capao!lities. Sigicied aio) Cit Veontains 
information on the initialization of the Vector General 
digi | ay System. Siac t 1.0m IV descrives the display 
compositionr element constructions, and oicture, object, and 
element Pedeait) OMisa1CS « sect von V provides ae brief 
gescription of the user supoort routines availatle in the 
supDort library. Finally, Section VI sorovides information 
necessary Tome como)! yaGc and executing user proqrams 


emoloying the Vector General qraohics display unit. 


4 
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I. INTRODUCTION 


The Vector General is an interactive graphics display 
system which has been interfaced with the PDP#11/50 
computer. The display interacts with a POP-e-i1 user by 
Siseiaying ocictorial information on the surface of a cathode 
may twoe anc by accecting information from  Vtso externel 
control devices. The external devices consist of an 
alphanumeric keyboard, $e lighted™ funetion switches, 10 
Commerc: G@yais, 3 trackball, a joystick, and a lightoen. 

An interactive graphics software orogram library has 
been constructed to interface the user and the Vector 
General cisolay controller. The software package provides 
the user witn sufficient routines to easily construct and 
manipulate gqraohic displays. Although the routines were 
aritten vm 8 Gy the user has the choice of two high-level 
languages with which to orogram. BASIC programs may now 
also interface with the Vector General through the use of 
the routines in the software supoort library. 

This manual does not attempt to discuss in detail the 
Gwcaroemic fumetions of the Vector General, or its interface 
meth the PDP-11. The ourpose of this manual is to instruct 
a user in the creation and manioulation of pictorial data on 
the Vector General display. A knowledge of © or Basic 1s 


assumed. 


Bile: 





TI. THE VECTOR GENERAL DISPLAY SYSTEM 


A more detailed discussion of the Vector General can be 
found 1m the Users Manual for the Vector General Display 
Unit (12) and the DOesign Manual for the Vector Genera] 


Pasteiay Unit (11). 


ee lime DISPLAY 


nme Vector Gen@ral is a cathode ray tube (CRT) display 
on which a visible pattern can be created Dy the movement of 
an electron beam. The electron beam causes a florescent 
soot to aooear on the face of the dispclay tube. The 
movement of the veam is controlled by a method called random 
scan, which in ome ftect Steers the spot 1n a straight line 
petween two points on the display screen. The resulting . 
Limemor wWector, combinied with others, creates a picture or 
pattern on the display screen, 

To maintain a clear oicture on the diselay screen 
requires that the pattern be redrawn on the tube repeatedly 
Se deemoximately thirty to forty times ae second. Each 
repetition is called a frame and the frequency with which it 
Boereonawm 1S called the refresh rate. Dieeeche spatternw) s 
not reoeated often enough a degradation of the picture wil] 
Seccummom the cisplay screen. This deaqradation is called 


fiveker. 
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B. HARDWARE FEATURES 


The system has several hardware features, in addition to 
@a vector aenerator,s, which gqreativ extend its capabilites. 
These itnelude the ability to produce three-dimensional 
figures, an ASCII character set, and the hardware generation 
of arcs and circies. Other features orovide the hardware 
mechanisms Tor the rotation and translation of user 
specifiec picture segments. These hardware features are 
controlled and coordinated by the disolay controller. The 
controller is resoonsible for handling the communications 
between the user, the external control devices and the 
Gisolay hardware. 

The main ourpose of the external control devices is to 
facilitate user interaction with the display. These devices 
Mee lude an alohanumeric keyboard, 3e lighted Lone Gaon 
Switches, Mlmeicoamerot GCials; a tracksaliz SS joystick, and a 
11 Givtoein. 

Additional information on the Vector Genera!) hardware 
can be found in the Graohics Disolay Peference Manual (13) 


and the Graonics Disclay System Technical Manual [14]. 


meme SYSTEM INTERFACE 


A Vector General user defines pictorial data and its 
Manioulation within a Basic or C orogqram. The execution of 
the orogram causes the Vector General software interface to 
be activatecd. It is this software which communicates user 


requests and receives information from the Vector General 
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controller. The software oasses user requests, in the proper 
form, womeune Oiolay controller. The controller will 
activate the orocer hardware generator (Cie. character, 
wMeetcor, ' arc/circlie) which will output the desired 
information on the diolay screen. The controller wil] also 
pass information from the external control devices back to 
the user via the interface software. This relationship is 


mmrustrawec im figuire An-l. 
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Interface Relationshio with the Vector General 
FIGURE Ae-i 


D. INTERFACE wITH EXTERNAL DEVICES 


Each of the the external devices communicate directly to 
the Vector Genera! controller. Information from these 
devices is returned to the user via the controller and the 


user interface. The user orogram may utilize the information 
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returned from these devices to control program flow. This 
allows a user to interactively control] and manipulate the 
pyctor)a | information at display time. Soee if ic user 
routines which activate these external devices and provide a 
communications channel with the user are discussed in detail 


in later sections of this manual. 


1. Alphanumeric Keyodoard 
The alphanumeric keyboard allows the user to input 
ierormat ron in the Onn Opec C lL lweGharactl etaGcodes sa Tiroudn 
the user interface the user can disolay the information = on 
the Vector General display screen. The data entered from 
the keyboard can also be returned to the user program (ftor 


orocessing. 


Cec Ometion Switches 
The 32 lighted function switches provide the user 
arth information which can be used to interactively 
Menmroulate oictorial data at disolay time. Each function 
Switch can be assignec specific meaning by the user Program. 
The user interface returns to the user information on which 
Mumg@ctenm Switches have been cressecd. A user program could 


use this information to selectively rotate, translate or 


perhaos scale particular oicture seaments. 


Eneaceamterol!l Dials 
The 10 control dials provide numeric information to 
the disolay controller, soecifying the degree to which each 


dial Mae oeen turn dd. This information, through the 


oli 





software, can be orovided to the user. A user program may 
wei} pee the values of the variable contro] dials in 
determining the distance or rate at which a portion of the 


picture may be moved or rotated, 


4. Trackbe" | 

Premtrackeal!l is an external device which uses a 
software-generated Sink dims cursor CC) SO Tove dewey) sual 
Besttironming feecoack to the user. The rolling action of the 
user's hand across the round trackball steers the cursor 
Beout the Gisolay screen. A routine is available to return 
the trackball] cursor position within the defined coordinate 
System so the user may Programatically use this information. 
Additionally, a routine is available to activate or 
deactivate the disolay of the software-generated cursor. 


Positioning information may be returned to the user whether 


eee met the’ cursor 1s displayed. 


een we Oyst ick 

The joystick is an external device, which like the 
trackball, uses a software~generated blinking cursor to 
provide positioning feedback to the user. Unlike the 
trackball which moves about only the XY olane, the joystick 
cursor appears to move in three dimensions. Movement about 
Phe xX=Y plane is accomolished by oushing the joystick fore- 
“at, ame side-to-side. Movement along the Z axis 
ioeroendicular to the disolay screen) is accomolished 
manually by twisting the knob on too of the joystick and 


visually on the screen by using the deoth=cueing facilities 
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ama verying the cursor intensity. bike tithe ‘trackbal 1, 
routines are available to return to the user the joystick 
cursor oosition and activate or deactivate the display of 


ene cursor. 


Oa LCightoen 

The lightoen, a wand containing a photo cell, can be 
used to selectively point to different picture segments on 
the display screen. The interface orovides a user crogram 
with information on which victure segment was oointed to by 
ene lignhtopen. A user program can turn the lightpen 
selectability of specific picture seaments on or off. For 
example, a user night select sections of a picture (for 
Sroswre by OOINntIing to them with the lightpen. 

The software additionally orovides for generation of a 
Iibpomecen cursor. The tlighteen cursor is a smalj] non- 
blinking octagon which nav be moved about the display screen 
ith the lighitoen. Two soeeds of lightpen movement are 
available. PeutiMes ts [OC FELUIPAIT RQ nthe we l1gntcen sseursor 
cosition and activation/deactivation of the cursor display 


are availacle within the software oackaae. 
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Pbia.s INITIALIZATION 


Bee INTERFACE INITIALIZATION 


The Vector General disolay system and the graphics 
semmmore woth the POP=-11 must be initialized before any data 
can be displayed. The initialization routine sysinit must 
be called before any other routines are utilized. This 
routine sets all the system default oarameters, such as the 
screen coordinate system. 

iteetor seme reason the initializatskon cannot be 
comoleted the user crogqram will be terminated. This error 
usually occurs because another user 18 accessing the Vector 


General. 


SpmeroreAyY INITIALIZATION 


Pee coordinate System 
The user can specify a two or three=-dimensional 
cartesian coordinate system. All display coordinate values 
referenced by the user will be interpreted according to this 
coordinate system definition. A user may redefine the 
coordinate scale at any time in a program. The user will 
define the coordinate system in a call to the routine 


EQioraes ys’. 


coordsys(dimspminx,maxxsminysmaxy [rminz,max2] ), 


oe 





The routine requires the user to specify if the 
coordinate system is to be two or three-dimensional and the 
range of each coordinate. If the oarameter '‘'‘dim' is two, 
magiacating. a two-dimensional coordinate system is desired, 
the range of the z coordinate can be omitted, and will be 
ignored if it should te included. 

If this routine is not called by the user the default 
coordinate system will be used. This default system is 
defined as three-dinensional with the x, Yr Z coordinates 
peameang from ~100.0 to 100.0. All coordinate values will be 
interpreted by this default system when coordsys is not 
oem Wed by thie user. 

As will be discussed later in this manual, both absolute 
and relative vectors may be utilized in constructing display 
elements. Should an absolute coordinate be specified which 
falls outside the defined coordinate system, a value of the 
nearest coordinate within the defined system will be 
assumed. Should a relative increment be specified which 
exceeds oneshalf the coordinate range (ie: !00 for default 


coordinate system) a value of zero will be assumed. 


Eww rcture Scale 
Muemrectamqular, !3 by 14 $j inch, portion of the 
display screen that can be viewed by the user is called the 
Uesvpte space. The maximum oi¢cture space 1S larger than the 
visiole soace, covering an area of 30 by 30 inches. This 
eM@itra area allows a user to rotate or move oart of the 


Srcture to the extreme boundaries) of the visible space 
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without any distortion. It also ocermits Jimited zooming. 

The pictorial data being displayed can be adjusted in 
size, or scaledsr by two different controls. One, the gain 
control dials on the Vector General display unit allow the 
user to manually manioulate the picture scale. The second 
provides scale control within the user's program by calling 
the routine oscale. This routine is discussed in detail in 


SeGctr1on V of this mnanual. 
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IV. CREATING A PICTURE 


Oe «6 PICTURE STRUCTURE 


All of the information that a user desires to display on 
the Vtc.tor General must be incorporated into the 
hierarchical poicture structure defined by the interface 
So fit wa re’. The three hierarchical levels are defined as: 
Picture» object, element. These levels specify the 
WnGeriying Structure of the graphical display and determine 
the ooerations a user can oerform on information associated 
with each level. 

Himemetermeoicture refers to all of the data that is to be 
Gisolayed on the Vector General display space. The term 
element refers to the smallest oicture segment which can be 
indeoendently referenced and changed without affecting the 
Pemainder of the oicture. Each element, or independent 
picture segment, has a unique name associated with it. A 
SeGnreecurony wor mmeanineful grouping, of telements is called an 
ob ject. Each object is also labeled by a unique name so it 
can be easily referenced by a user. Figure A-e illustrates 
the relationshio of the three levels in the actual structure 
of a picture. 

An element is comeletely described and named by the 
user. It can describe either graphical or ASCII character 


data. An element can be indeoendently added or erased from 
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Exampleti aw. one 


Hterarechnical Ficture structure 
FIGURE Ae-e 
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the display screen. It can be caused to blink or be 
specified as being liahtpen selectable. 

Each element must be associated with at least one object 
cefore it can be displayed on the Vector General. An object 
may consist of from one to ten elements. A user 1s 
resoonsibdle for establishing the desired objectrelement 
associationsr and for specifying a unique name for each 
object. Each user cefined object can be independently 
rotated, or translated to any section of the 30 by 30 inch 
display soace. An object can be added or erased from a 
muGrure, scaled, and specified to blink or to be l|ightpen 
selectable. Each object's intensity can be varied in order 
to give three-dimensicnal JSROeeS their depth queuing. These 
actions, when applied to a specific object, affect every 
element that has been associated with it by the user. 

A pictureemay contain from one to ten objects. The 
Gooedinate scale anc picture scale defined by the user 
affects the entire oicture.e. A oicture's coordinate scale 
can be varied but this action will affect every object 
diet i new ewes of the ovicturee An entire oicture can also 
be erased, specified to olink or be lightoen selectable. 

A summary of the operations for each level of the 


hierarchy is outlined in Figure A-3. 
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PTE TWRE : 


Define picture coordinate System 
Picture scale 

Picture offset 

Erase 

Display 

Remove 

Refresh 

Blink 

Lightoen selectable 


OBJECT: 


Translate 

Rotate 

Scale 

immensity scale 
Intensity offset 
Erase 

Disolay 

Remove 

B11 nik . 
Lightoen selectable 


ELEMENT: 
Erase 
Disolay 
Remove 


5 aiienk 
Lightoen selectable 


Summary of Operations Associated with Each Hierarchial Level 
FIGURE Ae-3 


B. CONSTRUCTING AN ELEMENT 


Every element is comoletely described by the user within 
an element block. There are two types of element blocks. A 
Graw element block describes graphical information. A 
character element describes ASCII characters that are to be 


disolayed. Each element is uniauely named and this name 
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will be used to reference this particular structure. 


1. Oraw Element Block 

A draw element block represents a group of draw 
instructions that describe a soecific structure, or picture 
segment. These draw instructions include setvector, move, 
line, arc and circle. A draw element block begins with a 
call to the routine drawele and is terminated by a call to 
the routine endele. The draw instructions that are executed 
between drawele and endele describe the actual oicture 
segment. 

The only oarameter required by drawele iS a quoted 
character See eae or pointer to a character string, 
specifying the mame the user wants to associate with this 
element. This name will be used throughout the program to 
reference this element block. 

The basic draw element block, and the related draw 


instructions are represented in the following format: 


drawele("element=name"),; 
setvector(vtyce,vmode, linc), [scale] J); 
---setvector(vtyoe,vmode,linc),(scalel); 
move(x,ly),(2z)); 
line(x, ly), (213); 
circle(dir,centx, (centy], {centz]); 
--- arc(dir,centx, (centy], lcentz) ,enax, lendy], lendz]); 


encele(); 


The user can select one or more of twelve vector tyoes 


ke 








_ 


Im constructing an element. These vector types describe how 
the coordinate data will be interpreted in drawing a vector 
on the disolay screen. The choice of a vector effects. the 
parameters that will be passed in each of the move, line, 
circle or arc instructions. The user soecifies a vector 


selection dy calling the routine setvector. 


ae Setvector 

This draw igs t we talon must be called 
immediately after drawele, and may be called any number of 
times within the element block. Each setvector, and the draw 
Wesotructions that follow itr comprise 9a subgroup. The 
setvector instruction determines the manner in which. the 
liners, moves arc and circle instructions in the subgroup will 
be interpreted, as well as their visual apoearance on the 
Gisolay screen. The routine is called with the 4) lepat ae 


Darameters. 
Setvector(vtyoe,vmode f{,inc] {,s,scale)); 


The parameter vtyce soecifies which one of the twelve 
yiecero r tyoes tne user wants the following group of line, 
mover, arc and circle instructions to utilize. The oarameter 
vmode indicates the vector moder or aopearance of the 
vectors to be drawn (ie, solid liner dotted line, etc.). 
Certain vector tyoes reauire additional information; this 
information is soecified by the parameters inc and scale. 

A prief summary of the twelve vector types is listed in 


Taole Ael, 
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NAME 


VA 


VAX 


VAY 


VAZ 


wk 


VRX 


VRY 


VRZ 


TABLE Ae] 


SUMARY OF VECTOR TYPES 


DESCRIPTION 


vector absolutes each coordinate is specified 
with respect to the oriain. Each point(x,y,z) 
references a unique point on the display screen, 


vector absolute autorincrement x7 every draw 
instruction causes the y and z absolute 
values to be updated while x is stepped by a 
constant value. 


vector adsolute autosrincrement y?; every draw 
instruction causes the x and 2 absolute 
values to be updated while y is stepped by a 
constant value. 


vector absolute autorincrement 2; every draw 
instruction causes the x and y absolute 
values to be updated while 2 is stepped by a 
constant value. 


vector relatives each xr yr 2 coordinate 

value indicates the amount that is to be 

added or subtracted from the previous absolute 
coordinate point. 


vector relative autosincrement x; each draw 
instruction causes the y and 2 coordinate values 
to be incremented by the specified value while 

x 1$ Sten0ed by a constant value. 


vector relative autotincrement yr each araw 
instruction causes tne x and 2 coordinate values 
to be incremented bv the specified value while 

y 1S steoped by a constant value. 


vector relative autotincrement 27 each draw 
instruction causes the x and y coordinate values 
to be incremented by the specified value while 

z is stepoed by a constant value. 
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TABLE Ae[I 
(continued) 


INC2= two-dimensional incremental vector; a 
relative vector that optimizes storage re- 
quirements. The coordinate increment values 
are limited to values aoproximately 3% of the 
user's coordinate ranqe. 


INCX= twordimensional incremental autorincrement x; 
1$ a relative vector that optimizes storage 
requirements. The y coordinate value is 
incremented by a small value while 
x 18 Stepped by a constant value. 


INCY= twordimensional incremental autowincrement y, 
1s a relative vector that optimizes storage 
requirements. The x coordinate value 15s 
incremented by a smal! value while 
y 18 stepped by a constant value. 


INC3= three-dimensional incremental vector; a 
relative vector that ootimizes storage re- 
Quirements. The x, yr 2 coordinate increment values 
are limited to values that are approximately 3% 
of the user's coordinate range. 


as: 





A more detailed account o f each vector type and the 
parameters required by setvector are listed in Aoopendix 8B. 
Figure A-4 illustrates the five different vector modes’ that 


are available. 


VECTOR MODE PARAMETER VALUE VISUAL APPEARANCE 
line LN 7 00 a a ne 
dashed Dotlee/ 020 eee eee ee 
dotted line DOT / 040 ee eee ee ee 
end soint PNT / 060 ° 

dash-dot-dash 0D / 0120 po a 
dash=dot-dash DOD 7 0140 coment 


Vector Modes 
FIGURE A-4 


oe Move 
The draw instruction move is used to reposition 
the beam on the display screen. It will produce no visible 


Pine® orf Oattern. The format of the instruction 1S: 


move(x (ry) (-2])? 


Poemeeordiaate values x, yr 2 will be either absolute or 
relative valueSe The vector tyoe selected in the 
preceeding setvector instruction will determine how the 
value of these carameters will be interoreted. 
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A move instruction under an absolute vector type will 
reposition the beam at the absolute coordinate given in the 
move instruction parameter list. Absolute parameter values 
which exceed the limits of the defined coordinate system 
will be assigned a value of the nearest coordinate within 
the defined system. 

A move instruction under a relative vector type wil) 
reposition the beam at a location determined by adding the 
Parameter values to the oresent beam location. Relative 
parameter values which exceed onerwhalf the coordinate range 
will be set to zero. 

The bracketed values indicate oarameters that may be 
optional. If the user coordinate system iS not three- 
dimensional, the 2 parameter can be omitteds and will be 


mamereqa if it should be included. 


€. ) Lire 
Wren line imstructionm draws a visibl line or 
vector on the display screen. The Jine is drawn from the 
oresent oeam locaton to the soecified end point. The format 
Pome minstruction is: 


ime xoamls V1 ez); 


Tee coordinate values x» yr z will be either absolute or 
relative values. The vector type selected in the previous 
setvector determines how the value of these parameters wil] 
be interpreted. 


A line instruction under an absolute vector tvoe will 
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Graw a line from the cresent beam position to the absolute 
coordinate specified in the line instruction parameter list. 
Absolute oarameter values which exceed the limits of the 
defined coordinate system will be assigned a value of the 
nearest coordinate within the defined system. 

A line instruction under a relative vector type will 
Graw a line from the present beam ososition to a point 
determined by addina the parameter values to the present 
beam location. Relative parameter values which exceed one- 
half the coordinate range will be set to zero. 

If the user has cefined a twosdimensional coordinate 
system, the z oarameter can be omitted, and will be iqnored 


mere should bie incliucecd. 


ee GIYFC Ie 
fem ctrele i mstructiom will} Graw 6 circle 
BESqianing at the present beam location about the center 
point soecified by the user. The difference bdetween the 
oresent beam location and the center point deternines the 
Meeius of the circle. The Oo mst ructvome wis ) Usec by the 


PoVlOowing format: 


cirpele(dir,centx [(,centy] [,cent2]); 


The oarameter dir indicates in which direction the 
circié is to be drawn, clockwise or counterclockwise. [The 
number of Oarameters reauired and their values are 


determined by the vector tyoe selected in the previous 


setvector instruction. 
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Circle commands issued under absolute vector types will 
cause the circle to be drawn about a center point as 
specified in the parameter list. Absolute parameters which 
exceed the limits of the defined coordinate system wil] 
assume a value of the nearest coordinate within the defined 
Sy S CCM a 

Circle commands issued under relative vector types wil] 
cause the circle to be drawn about a center point determined 
by adding the parameter values to the present beam location. 
Relative oarameter values which exceed oneshalf the 
coordinate range will be set to zero. 

lf the user coordinate systen is twordimensional, the 2z 
parameter can de omitted, and wil] be igqnored if included. A 
circle cannot be drawn by any of the four incremental 


vectors. 


e-) Arc 
woemare instruct vom will draw an arc from the 
Seesemt beam locations about the specified center points to 
the desired end point. The distance between the startina 
Dommt.) ana the center ooint determines the radius of the arc 


DwIng drawn. The instruction format is ° 


arc(dir,centx [(,centy] [,centz],endx [,endy] [(,end2}]); 


The ovarameter dir, gives the direction the arc 18 to be 
drawn, clockwise or counterclockwise. The arc's actual 
center and end points are determined by the vector tyoe 


selected A the orevious call ae, setvector, and by the 
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SuUppDITed Darameter values. 

Arc commands issued under absolute vector types will 
result in the center and end points being absolute 
coordinates as aqgiven in the command parameter list. 
Absolute parameters which exceed the limits of the defined 
coordinate system wil] assume a value of the nearest 
coordinate within the defined system, 

Arc commands issued under relative vector tyoes will 
result in the end point of the arc being determined by 
adding the endx, endy, and endz values to the oresent beam 
mOCation. The center point is then obtained by adding the 
centx, centysr and centz values to the end point. Relative 
parameters which exceed onewhalf the coordinate range wil] 
Beescet CO zero. 

If the user coordinate system has deen defined as two 
dimensional, the 2 parameters can be omitted, and will be 
19n0red if included. An are cannot be drawn by any of the 
four incremental vectors. 

imeeeme distance from the starting point of the are to 
@hie Center point, and the distance from the end point to the 
center point are not equal, the resulting arc will contain a 
straight uae. the straight line results from the arc 
Generator trying to compensate for the two different 
distances to the center point. One distance will be used to 
determine the radius of the arc? the are will then be drawn 
tise this radius. The arc will stop at the systems new 
defined end point and a straight line will be drawn to the 


end point that had been spvecified by the user. The resulting 
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arc apoears in the following form: 


2. Character Element 

A character element represents ASCII character data that 
mseoebie imcermpoerated into the ovicture structure. A user can 
soecify a character element containing ASCII, special Vector 
General characters ana formatting symbols to be disolayed on 
the Vector General display screen. A user can select from 
four character sizes and has the option of selecting a 
Siramgeerea character set. The text can be displayed 
horizontally or vertically on the screen. The vertical 
position causes the characters to aopear as if they were on 
a page that had been rotated ominety degrees counter 
clockwise. The user can select the vosition on the screen 
where the string is to beqins or can output it relative to 
Bnew oresent beam oosition. 

Each character element is given a uniaue name by the 
user. iheisae name will allow the user to easily reference 
each character element. There are two routines which can 


produce character element strings. 


ke Charele 
The charele instruction produces a2 character 
element string of a given lenqth. The charele character 


element generally reauires Jess disolay list space than the 
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printv character element and is designed tor elements which 
@e rot change. The character element is represented by the 


following format: 


charele("element-name",stringssizerwdirrsslant,x,y)3 


The oarameter string can be either a quoted. strina 
within the oarameter list or a pointer to a character string 
or array. The character string will beaqin at the point(x,y) 
or can be output relative to the present beam location by 
replacing the x and y parameter with the constant VGREL. 
For example, the following character elements when linked to 
am Coject, would be outout relative to the present beam 


position: 
charele("elementename","Now is the tine”™,SZ4,HOR,SLNT,VGREL); 
A Summary of the character element parameters 1s 


presented in Table AelIl. The character set available on the 


Vector General is illustrated in Figure AS. Al] o f the 


Vector General Gwardc tego sc am be represented within a 
character string. The soecial formatting symools and 


special Vector General characters are listed in Appendix B. 


Be 





tae le wait 


SUMMARY OF CHARACTER ELEMENT PARAMETERS 


size: specify character size 


az / 00 =—UsemorevyiogusSiy Gefimed ecnaracter size 
eel 7 0100 = set size to 100 columns by 60 IJines 
peer? 0120 = set size to 8&1 columns by 41 lines 
$Z3 / 0140 - set size to 60 columns dy 30 lines 


SZ4 / 0100 = set size to 32 columns by 16 lines 


mor: write direction 


HOR / 00 =iwriscelenaracterns Om im2on ta inl y 


VER / 0200 - write characters vertically 


slant: specifies regular or slanted characters 


Sent / 00 - slanted characters 


NSLNT/ Ol - regular characters 
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Character Set 
FIGURE A-5 
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e PrRraty 
The orintv instruction provides for a formatted 
output character element string of variable length. Maximum 
character length for a orintv character element strina is 
moo characters. The orintyv character element is designed 
for output character strings which change frequently. The 
orintv character element 1S represented by the following 


tO rimet : 


orintv("“elename",size,wdir,slant,xpos,yoos, "format" 
( (Ade G ee OC 6. enis OF a1 } ); 


The first Six Darameters are identical 1m use to the 
charele format tn initializing and positioning the character 
ering. tite orintv character string cannot, however, de 
positioned relatively bout must be supolied with both X and Y 
absolute coordinates. The format parameter and ten optional 
arg oarameters are used as in a standard orintf statement In 
TOrmatting output. 

An examole of the use of the oprintv character element 


would pe as follows: 


ome y  SESUL_t”,SZ4,HOR,SLNT,5.0,0.0,"result = 4d", 
result), 


and could be changed later in the program to: 


Orinty("RESULT",SZ3,HOR,NSLNT,-10.0,15.0,"score = id", 
score); 
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C. LINKING ELEMENTS TO OBJECTS 


Draw and character elements represent the smallest 
picture seqment that can be indenendently referenced by the 
user. In order to display an element it must be associated 
with at least one object. An object represents the smallest 
entity that can be displayed independently on the Vector 


General screen. 


ieee Oourect Routt né 

Each object is given a unique name so it can be 
easily referenced by the user. Elements can be linked to an 
object at one time or dy several different calls to _ the 
moumwme Callied object. An object can consist of one or more 
elements. A specific element can be linked to several 
agifferent objects, or may be Jinked to one object several] 
times. This objectrelement association or Jlinking 1S 
established by the routine object. This routine has the 


fmol liowwmog format: 


object (num,"“objectoname","element=name",..., element=name”"); 


The parameter num indicates the number of elements” that 
are to be linked to the named object by this call. The 
elements are referenced by the names specified by the user 
in the preceding drawele, chareles, and orintv routines. 
Since each object is associated with a unique name, a second 
call to objects with a duplicated object name, will cause 


the elements to be added to the object first associated with 
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that mame, 
when an element 18 linked to a specific object several 
times, the user can no longer reference a specific 


occurrence of this element within the object, for example: 


object (3,"Tree","branch","branch","*branch")? 


In this case the element branch has been linked to the 
epayec t tree three times. “then displayed, element oranch 
ml) eaepoear three times. Now, however, the user cannot 
uniquely reference a specific occurrence of the element 
branch. If the element called branch was selected to be 
erased, the first occurrence of branch would be erased from 
the screen. In many instances it may be desirable to 
uniquely reference each occurrence of an element within a 
Boece Object. This can be accomplished by associating 
several uniaue names with an element. The routine copyele 


oroviges tnis capability. 


Ce. Copvele Routine 
This routine allows a user to assign several untaue 
names fommea seecific element strueture. In this ways an 
element structure can be associated with an object several 
times and each occurrence can be uniauely referenced. Tne 
routine is reoresented by the following format: 


e 


cooyele(num,"“element-name","copyl=name","copye=name"s...)7 
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The parameter num indicates the number of additional names a 
user wishes to associate with the named element structure. 
The “elementename" refers to a previously defined draw 
element or character element block. Eachionmee ne. copy = 
names” must be unique. 

Now reconsider the previous examole. If the element 
branch iS associatec with two other unique names and these 
three names are used in the objectrelement linking, each 
occurrence of the structure can now be uniquely referenced 
oy the user. The following two statements) will accomo)]ish 


tres task. 


eoovyeuetc, branch”, ”“branchi","“branche”); 


Sommect(5,"tree"+”branch",“branchi","“branche”"); 
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Ve. USER SUPPORT ROUTINES 


Beter the wser has incorporated a}] data that is to be 
disolayed into the desired picture structure, it can now be 
manioulated and transformed. The following user routines 
orovide the means to manipulate the picture, objects and 
elements that have been created by the user. 

A descriotion of each user routines, calling format. and 


error diaaqnostics are included in Aopendix 8. 


ir Lemurme REPRESENTATION 


ee Sil a7 
The display blink mode can be set tors. thew eatire 
eucture, single object or for any number of elements 
associated with a specific object. Modifying the blink mode 
of an object affects all the elements associated with that 
object. The routine blink will turn the blink mode on or 


off for the sonecified picture seqment. 


2. Erase 
The entire picture, a single object or any number of 
elements associated with a specific object can be erased 
from the display screen. The picture segments that are 
erased from the screen can be redisolayed by again 
establishing the desired objectrelement association. This 1s 


accomplished ov calling the routine object, as described 
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earlier. Erfoasing an object will affect al) elements 


associated with the named object. 


3. Remove 

The routine remove provides a user with the ability 
to release the memory locations associated with a specific 
element structure. The user can remove the picture. and 
release all the memory locations that have been used to 
describe all the existing elements. Additionally the picture 
will be erased from the screen. Each element that is removed 
from memory can no longer be referenced or linked to 
objects. An indiviaqual element can also be removed from 
memory. This will cause every occurrence of the element to 
be erased from the screen and the memory locations 
associated with the element's description will be released. 
The user can soecify an element for removal by either its 
original name or by any of the copy names associated with 
it. Remove results in the elimination of all occurrences and 
all copies of an element from the display screen. An 
element that has vpeen removed can ve redisplayed only Dy 
reconstructing the element block and by again establishing 


the desired objectstelement association. 


4. Disolay 
mre Gisplay of the entire oicture, an object, or 
individual elements may be activated or deactivated with 
this routine. Objectrelement associations are not affected 


with this routine as they are with erase and remove. 
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Deemer re sh 
The default disolay refresh rate is 40 Hz and may be 
altered from 15 to 120 Hz with this routine. High refresh 
rates ensure no flicker but may not allow enough time to 
execute all desired draw commands before refresh begins 
again. Low refresh rates allow more draw commands but with 


an increase in flicker. 


See ufftset 
Picture coordinate axis positioning is normally 
centered on the display screen but may be altered with this 
routine. Alterinaqa of the obdicture coordinate axis will 


Srem@ct a!! objects in the picture. 


fame Sc a |e 
Modification of the Di cture scale may be 
Become lisned by calling this routine. All objects within 
meme Guspliay are affected by a modification with this 


routine. 


SB Intensity Offset 
The routine intoffset allows the user to vary the 
Pacvensity level of a three-dimensional objectr or impose a 


scmeen cut-off olane for the named object. 


9. Intensity Scale 
The routine intscale allows 8 user to vary the 
intensity of a three-dimensional object. This provides the 


depth=cueing or shading for a three-dimensional object. 
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SB. FreTURE MANIPULATION 


eo emote te 
This routine allows a user to rotate an object about 
the xs yr and Zz axis. The rotation of an object affects all 
elements associated with the named object. Ares, circles 
and characters are always drawn in a plane parallel to the 
screens and are rotatable in a three-dimensional coordinate 


system adout the z-axis. 


eae ocale 
The routine scale allows a user to independently 
scale any object of the picture. All elements associated 
with the object will be scaled by the specified scale 


maGtoOr . 


S.  troamslate 
The routine trans allows the user to move an object 
anywhere in the diselay space. Tne object and all its 
associated elements can be moved in the xr yr and z olanes. 
Continually translating an object by very small increments 
will cause it to apoear as if it iS moving across’ the 


Giselay screen. 


4. Place 
The place routine allows the user to place or 
soSs1t1on an Op ect anywhere in the display space. 
Soecification of an absolute coordinate value will cause the 
Coordinate axes of the object to be centered on the 


specified value. 
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meeeAWeRNAL DEVICES 


nee CuUrSOr 
ius routrme allows the user the option on 
activating or deactivating the display of the trackball, 


Poysticks or lightpen cursor. 


Cie OS it 
This routine will return to the user a_i floating 
point value of the vosition of the trackball, joystick, or 
lightoen cursor. The cursor need not be displayed for this 


Poutum@ to work. 


peewee yooard 


ae Caet 
The routine cget allows a user to receive” and 
output characters from the Vector General keyboard onto the 
display screen. The ASCII character data is also placed in 
a user specified character array for processing by the 
Heer’ s program. Up to lei characters can be entered. Data 
entry 18 terminated by a carriage return. The termination 


of the data entry also erases the outout characters from the 


display screen. 


owe Faet 
The fgoet routine returns to the user a floating 
D01iNt number entered from the Vector General keyboara. This 


routine uses both the cget and getf routines. 
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e.. lget 
The iget routine returns to the user an Integer 


entered from the Vector Genera] keyboard. This routine uses 


both the cget and geti routines. 
4. Lightpen 


ae kLohtpen 
The lightoen selectability of the picturer a 
single object, or any number of elements associated with a 
meecrryc OOject can be turned on or off by this routine. 
This determines what picture segments will) be affected by 


biesimepen interactions. 


Bae P@ahit 

After an element's Jlightoen selectability has 
been activated with them lontoan routiae, Getermination of 
whether or not an element has registered a liahtpen hit 1S 
Secomolvsmed with this routine. A one 1s returned if a 

lightoen hit has occurred, otherwise a zero is returned. 
poneeven -elvement to reqister a lightpen hit it is 
necessary not only for the element's lightoen ee 
to have oveen activated, but also the Tlightpen must be 
pointing at the element and the lightpen sense switch must 
oe activated. The lightoen sense switch iS activated by 
Seraocing the smal | rubber gac on the forward part of the 


ign t oem. 
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Cree lrh yt 


This routine is used to clear the elements of 
lightpen hits. Element lightpen selectability is unaffected 


by this routine. 


5. Function Switches 


a. Fsman 
This routine returns to the user an indication 
of whether or not a specified function switch is depressed. 
A one 1s returned to the user if deoressed, otherwise a zero 


+f returned. 


Bae Fstog 
This routine makes the function Switches appear 
wee toggle switches. Ged Clstworcdy as. Ieese leet TOMS Or a 
Switch light the lamp and return a value cf one. Even 
(2ndr,4th,.--) selections turn the lamp off and return a 


value of zero. 


Gre Lamo 
The lamo routine will light or extinguish the 


soecified function switch lamo. 


d=  lanint 
Each deoression of the manual interruot function 
switch increments the manual interruot count by one. The 
manint routine either returns to the user the present manual 


yei@erruot count or sets that count to zero. 
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lowe Control Dials 
The dial routine returns a floating point number from 
=1.0 to 1.0 to the user to indicate the relative position of 


the specified control dial. 
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VI. RUNNING A VECTOR GENERAL PROGRAM 


A. PROGRAM FORMAT AND COMPILATION 


In order to properly utilize the Vector General display 
system, routines to initialize and terminate the system must 
be called. These routines initialize the Vector General, 
Start tne actual visual disolay and prooerly terminate the 
display at the end of a user's orogram. Each user program 
must include acall to these three routines: 

Sysinit(); 
vae7cture(); 
vgterm(); 

The first routine, sysinit, must be called by the user 
before any other user interface routine is called. To 
Greoray the picture that a user has described on the Vector 
General Screen, the routine vapicture must be called. This 
routine is called only once, and nothing will aorpear on the 
Screen until Vemenas) beens) Called. Finally, to prooerly 
terminate, the system requires a call to the routine vaterm 


at the end of the user orogram. 


cnr rograns 
fomenrooperly initialize verious data structures in 
the interface routines and utilize the Vector General 
S9rogram constants usec in this manual the first line in the 


user's program should be: 
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#include "/usr/graph/vgdata" 


Once a C orogram has been written it must be comoiled 
with the user interface graphics subroutine library. Toe 


accomplish this the following command must be issued: 
vgc filename.c 


The result of a successful compilation is an executable 


ee out file. 


Die Basic Proarams 
The first subroutine cal] made by Enes PAS TC meorcoramn 


should be: 
call vadata() 


This causes Ene | cading of the initialized display list. 
Care must be made in previously declaring the "vadata" cal] 
on 8ohern statement before this call. This call would 
be in lieu of the "“inelude™ statement used by the C 
prOGmams . 

The program constant names used in the C Vector General 
programs do not apcly in BASIC Vector General orograms. 
Conversion values must be utilized instead of the string 
constant names when orogramming in BASIC. The following 
table Jists the constant names and the equivalent values in 


decimal number representation to be used: 


PemUNeE VECTOR SIPt S 


VR = 4096 VAY = 4102 
VRX = 4097 VAZ = 4103 
VRY = 4098 INCe = 4104 
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hie 


VRZ = 4099 INCX = 4105 
Vi = 4100 INGY = 4106 
Vox = 4101 eS ee 1) 7 
DEFINE VECTOR MODES 
LN = Q PT = 48 
DSH = 16 OD = 80 
DOT = 32 DDD = 96 
DEFINE COORDINATE FIELD VALUES 
AIR = 0 X = 0 
XR = | Y = 1 
YR =e Z2=e 
a 
DEFINE OF AND CF FIELOS FOR ARC COMMANDS 
cE = 4 
wee 6 
CEFINE FIELOS FOR INCREMENTAL VECTORS 
INCREMENT SCALE 
NMG = 0 
mG = 128.0 
DEFINE CONSTANTS FOR CHARACTER GENERATION 
SLNT = Q VGREL = -.00001 
NSENT = 1 
CHARACTER WRITE DIRECTION 
HOR = Q 
VER = 128 
SAARAGTER SIZE 
s2 = 0 $Z3 = 96 
SZ1 = 64 S74 = i112 
Sze = 80 
DEFINE ACTION PARAMETER 
ON = 1 CLEAR = Q 
OFF = 0 COUNT = 1 
DEFINE CASE STATEMENT VALUES FOR OBJ-ELE=PIC 
PIC = 0 ELE T=) 
OBJ = =] 
DERENE DEVICE SWITCH NUMBERS 
LPEN = QO JOY =e 
rae = } 


Once a BASIC owrocram has been written, 1t must obe 
compiled with the various user subroutine li1oOraries. To 
accomo)jish the task, the following system resident command 


must be issued: 


vqab filename.b 


The result of a successful comoilation is an executable 


"se .omae” file. 
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B. SAMPLE PROGRAMS 


inc we rocramns 
The following is an example of a C-language Vector 
General graphics program. The actual ojicture produced by 


this orogram is illustrated in Figure A-6, 


Zinclude "/usr/graph/vgdata" 


main() 
{ 
mt 13 
sysinit(Q); //initialize the Vector General 


//agefine coordinate system 
coumesivist 2,=—1-20,1.07—-1.0,1.0): 


Grawele("“box"); 
setvector(VA,LN); 
move( =e. 0,-1.0); 
Vine( 1.0,-1.0);3 
line ( | . 0% aa, 
immgie(=—1507° 1.0); 
lbeme (—120,=1.0); 
endele(); 


Chonmee( mame", SI BOX",SZ4,HOR,NSLNT,VGREL); 


drawele("zigzaq"); 
setvector(VA,LN); 
move(-0.5,-°0.5); 
setvector(INCX,LN,.03,NMG); 
FOR uCl=0 7 15 7 Ff 1+* ) 
line(.03,-.03);3 
enocele(); 


//establish objectrelement relationshio 
op yeet(5,"“biteobox","“box","name","*zigzaq"); 
Sumecte ts, Smallbox"s"box","name","21igzaq"); 


Scalem bigqdox",0.5); 

trame "bb wabox",-0.5,-0.5);3 
scale("smallbox",0.25); 
tramesme smal !box",0.5,0.5); 


vagpicture(); JF AGNVSO Vay Oicture 
sleep (30); //disolay oieture for 30 sec 
vaoterm(); //rerminate Vector General process 
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eaeecasic Program 
The following is an example of a BASIC Vector General 
Seaenics program. inewedctmal “oOVcture produced by this 


program is illustrated in Figure A-6. 


rem external subroutine declarations 
extern vgdata() 
extern sysinit(integer) 
extern coordsys(integer,double,double,double,double) 
extern drawele(&char) 
extern setvector(integer,integer,double,double) 
extern move(doubdle,double) 
extern line(doudle,double) 
extern endele() 
extern charelel&char,&char,integer,inteager,integer,double) 
extern objectlinteaer,&char,&char,&char,&char) 
extern scale(&char,double) 
extern trans(&char,double,double) 
extern vgpicture() 
extern sleeolinteger) 
extern vgtern() 


rem initialize display list 
call vgdata() 

rem initialize the Vector General 
call sysinit(0) 

rem define coordinate system 


call coordsys(2,2-1.0,1.0,71.0-1.90) 


call drawele("box") 
call setvector(4100,0,0,0) 
call move(-1.0,-1.0) 
eae) 1) ner] .0,-1.0) 
call lime(1.0,1.0) 
cen] ltime(-1.0,1.0) 
eemtt linele-1.0,-1.0) 
call endele() 


call charele("name","aI BOX",112,0,1,7.00001) 


call drawele("zigzag") 
call setvector(4100,0,0,0) 
call move(-9.2,0.0) 
call setvector(4105,0,.93,0) 
fomeye- 0' tO 6 
eal lilinel.05,—. 05) 
next} 
call endele() 


rem establish objectrwelement relationship 
cianl | ooject(3,"bigbox",“box","name","zigzag") 
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ea bh} 
ea iri 
Gian | 
cal] 
cal] 
cal] 


€a) i 


cal] 
end 


Serect (Ss, smal ibox",”"box","name","zigzag") 


Beale oiaqbdox",0.5) 
trans("bigbox",-0.5,-0.5) 
scale("*smallbox",0.25) 
Means ( smellbox",0.5,0.5) 


rem disolay picture 

vgopicture() 

rem dgsolay oi1cture for 50 sec 
sleeo(30) 

rem terminate Vector General process 
votermn() 





Box 


BOX 


Picture Displayed by Sample Proaqram 
FIGURE A-6 
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te ERROR DPAGNOSTICS 


A user can contro} the printing of error messages 
through the use of the errormsg routine. The general format 


of an error message wil!) be as follows: 


Eenn TTTT: "“eeee”" in routine rrrr() 
where: 

nn = error number 

TTTT = error type 

eeee = error 

emt ~ CoOutimenih error 


For example: 
ee e=! BLOCKS: in routine line() 


Message indicates a block error in routine 
line(). Probable cause is a line() command issued 
outside a drawele() block. The line() command wil) 
be disregarded and contro) returned to the user's 
program. 


ec. ES NO OBJ: “Tree” in routine erase() 


Message indicates that the object ‘free’ has 
been used in the erase() routine and no such object 
currently exists. Routine will be disregarded and 
Gomtrol rfeturned te the us®r’s Ppmogram. 


Bee Em lS xX? ~weou 000000" {nm Froutine printy () 


Message indicates an improper X coordinate 
value in the printv() routine. The erroneous X 
coordinate value of 150 will be reduced to a value 
within the defined coordinate system (ie: 100 for 
default coordinate system) and the routine wil] 
Gamt inte emecution. 


4. E225 NUM OTAL: "36" in routine dial () 
Message indicates an improoer dial number 
of 36 used in the aial() routine. Routine will 


return a value of 0.0 to the user. 


A brief idea of the cause of the error may be gained 
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Prom the error tyoe specification in the error message. 
Hopefully with a soecification of the error, the error type 
and routine where the error occured, the user will be able 
to quickly trace and correct the problem. Should a more 
detailed exolanation be desired, a fuller description of the 
specified error may be obtained with the help of the error 
number and error diagnostic tabler or by reviewing the 
GCiagnostic section under the routine in question. 

The software Supoort vackage is designed so that most 
errors will not terminate a user's program, and in fact most 
errors will usually result in the termination of the 
specified routine and return control to the user's program. 
Every effort will be made to execute the support routines 
emo user's program to completion so that at least some of 


the user's data will be disolayed. 


TABCE = iit 
ERROR DIAGNOSTIC TABLE 


E=-1 ELEMENT BLOCK ERROR © The. specified routine is in 
error in one of two respects. Either the routine 
has been called outside a drawele() block when it 
should be withins or the routine has been called 


within a oarawele() block when it should be 
Ott s idiex The instruction will be ignored and 
Gegueral eeturned to the, “user's program. Block 


errors have a tendency to occur in grouos when the 
orogrammer is not careful in constructing element 
bitoe ks. 


E=-2 SPACE ERROR = Space allocated by the system for 
the bouilding of elements has been exceeded. See 
the routine remove 1n order to free uo unnecessary 


element memory locations. The instruction 
executing when this error occurs will be ignored 
and Contra! wil] be returned to the user's 
program. 

E= 5 DIRECTION ERROR = The value of the oarameter '‘'air' 
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= 10 


ait 


was not Sor “CCl ™m the specified routine. A 
direction of C4 owl) be assumed and the routine 
will continue execution. 


CHARACTER ERROR = A character symbol included in 
an ASCII character strina is undefined. The 
symbol will be ignored and control wil! be 
Gecurmed to the user's orogram. 


OBJECT ERROR = The named object does not exist; it 


has not been defined in acall to the routine 
Sonect (). A specification of a non-existent 
object wil) terminate the routine and return 


control to the user's program. 


ELEMENT ERROR = The named element does not exist} 
it has not been defined in a call to drawele(), 
Ccharele(), or printv(). For routines that specify 
@ numbdver of element names, this tyee of error 
normally results in skipping the specified element 
and continuing the routine with the next element. 


DUPLICATE ELEMENT ERROR = An element name has been 
GUrirtcared 19 o drawele() of charele() call. Each 
element structure created by drawele() or 
charele() must have a unique mame. This error 
usually results tn either skipping the designated 
element and continuing the routiner or termination 
Cieeane FOuUcCInNe and, return to the user's oroaqram. 


ELEMENT NUMBER ERROR -The total number of elements 
allowed by the svstem has been exceeded. Maximum 
number of elements allowed is 70. The user shoulda 
consider using the remove() routine to delete 
unnecessary elements SO New elements may be 
lImteoauced. 


OBJECT NUMBER ERROR = The number of objects allow- 
ed by the System has been exceeded. Maximum 
number of objects its 10. 


VECTOR MODE ERROR - Specified vector vmode in 
setvector() routine is in error. A vector mode of 
LN will be assumed and the routine will continue 
execution. See the setvector() summary (for 
allowable vector mode codes. 


DIMENSION ERROR «= The coordinate dimension speci= 
fication is in error. Either the 'dim' parameter 
in coordsys() is in errors, or a vector type of VAZ 
or VRZ has been specified with a twordimensional 
coordinate system. The routine in question will 
be skipped and control returned to the user's 
Sinciaram . 
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E-14 


E=16 


B17 


= lus 


E*19 


ADD ELEMENT ERROR -An error has occurred in eget () 
or object() in attempting to build a new element. 
Routine terminates and control is returned to the 
user's orogram. 


MAKE OBJECT ERROR = An error has occurred in 
eget() or object () in attempting to build a new 
Obsiect. Routine terminates and control 1s 
returned to the user's program. 


VECTOR TYPE ERROR - An improper vector type was 


soecified in routine setvector().. A vector type 
of VA will be assumed and the routine will 
continue executing. See the setvector() summary 


for allowable vector tyoe codes. 


X COORDINATE/INCREMENT ERROR - The specified x 


parameter exceeds allowaole lama ts. Lf an 
absolute x coordinate exceeds the defined 
coordinate Svstem, the x value will be set to the 


value of the nearest coordinate within the defined 
System (xmin or xmax). If the oarameter specifies 
am x increment which exceeds onewhal f the 
coordinate range, the parameter is set to zero. 


Y COORDINATE/INCREMENT ERROR - The specified y 
Darameter exceeds allowable emiiee Ses If an 
absolute y coordinate exceeds the defined 
coordinate system, the y value will be set to the 
value of the nearest coordinate within the defined 
System (ymin or ymax). If the parameter specifies 
a y increment which exceeds onemhal f the 
coordinate range, the parameter is set to zero. 


Z COORDINATE/INCREMENT ERROR - The specified 2z 
Darameter exceeds allowable limits. If an 
absolute 2 coordinate exceeds the defined 
coordinate system, the z value will be set to the 
value of the nearest coordinate within the defined 
system (zmin or zmax). If the parameter specifies 
a 2 increment which exceeds oneshal f the 
coordinate range, the parameter is set to zero. 


ELEMENT NUMBER ERROR - The parameter ‘'num' speo- 
cifying the number of elements being passed in 
this Poutin@® is not 7-1 to 10. A ‘num' value of 10 
wil] be assumed and the routine will continue 
executing. 


CIR/APC ERROR = A circle or are cannot be drawn by 
an incremental vector. The routine is skipped and 
control] returned to the user’s oOrogram. 


USER BUFFER ERROR -= The size of the supplied user 
buffer has teen exceeded. Either enter a carriage 
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return or erase (cntri-a) part of the buffer. 


ADD OBJECT ERROR = An error has occurred in eget U) 
or object() in attemoting to add an object to the 
disolay. Routine terminates and control returned 
to t€me user's program. 


OBJECT LINK ERROR = The specified element is not 
linked to the specified object. Error usually 
results in skiooping the element in auestion = and 
continuina the routine with the next element. 


FUNCTION SWITCH NUMBER ERROR =An jimoroper function 
number was soecified. The routine terminates and 
control is returned to the user's program. A 
value of zero iS returned to the user. 


ACTION VALUE ERROR = An imoroper action value was 
specified In this routine. Refer ate routine 
summary diagnostics for specific action taken. 


OITAL NUMBER ERROR - An improper dial number was 
soecified in routine dia). The routine 
terminates and a value of 0.0 is returned to the 
user's orogram. 


ELEMENT ERROR w-Element specified in printv routine 
was specified earlier as other than a printy 
element. Routine will be skipned and control 
returned to the user's program. 


DEVICE NUMBER ERROR -An improper device number was 


used in this routine. For sysinit() a device 
number of zero will be assumed and the routine 
will continue. For cursor() or oosit() the 


routine will terminate and control will return to 
the user's crogram. The oosit() routine will also 
return a value of 0.0 to the user. 


COORDINATE SPECIFICATION ERROR |= The specification 
of a coordinate in this routine iS in error. The 
routine terminates and a value of 0.90 18 returned 
to, the. user. 


DIMENSION ERROR - Neither the lightpen nor the 
Ceceroal | have a 2 coordinate specification. The 
routine terminates and a value of 0'%.0 18 returned 
to the user. 


VALUE ERROR - The ‘val' parameter in intscale() or 
intoffset(), or the trate’ parameter in refresh() 


is in error. The routine terminates and control 
returns to the user'S program. 


CUT ERROR = The ‘cut’ parameter in intscale() 1s 
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fiGtazeroO Or one, The routine terminates and 
COmerol Peturned to the user's orogram-. 


DUPLICATE LINK ERROR = The specified element is 
al- ready linked to the object. The routine 
continues execution with the next specified 
element. 


BUFFER LIMIT ERROR - Either the supplied user buf- 
fer has been filled or 121 characters have been 
read in the caeét() routine. The routine wil] wait 
for either a carriage return or erasure (cntrl-a) 
Grmoaec of the buffer contents. 


FORMAT ERROR = The desired output string exceeds 
100 characters in the printv() routine. The 
routine will] orint only the first 100 characters. 


WRITE ERROR -| The write direction parameter is in 
mG or. A default value of HOR will be assumed and 
the routine continued. 


SLANT ERROR = The slant oarameter 15 1n error. A 
default value of NSLNT will be assumed and the 
pout ime continued. 


SIZE ERROR |= The size oarameter 15s 1N error. A 


default value of SZ4 will be assumed and the 
pout ime-. continued. 
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APPENDIX 6B 


USER SUPPORT ROUTINE DESCRIPTIONS 


The description of the user interface routines aorear in 
a format similar to the routine descriptions in the UNIX 
Reference Manual) at the Naval Postgraduate School] Computer 


Laboratory. 
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NAME : 
arc 7 Graw an are 
SYNOPSIS: 
e=dimensional coordinate system 
VR/VA $ arc(dirrcentx,centy,endx,endy) 
VRX/VAX: arc(dirrcenty,endy) 
VRY/SVAY: arc(dir,centx,endx) 
VRZ/VAZ: not allowed 
3-dimensional coordinate system 
VR/VA > arc (dir,centx,centy,centz,endx,endy,endz) 
VRX/VAX: are(dir,centy,centz,endy,endz) 
VRY/VAY: arecl(dirrcentx,centz,endx,endz) 
VRZ/VAZ? arc(dir,centx,centy,endx,enay) 
int dirs CC / 004 = counter clockwise 
C / 010 - clockwise 
float centx,centyrcentz,endx,endy,end2z; 
DESCRIPTION: 


An arc is drawn from the present beam location, about 
aeGemcer wooinmt Wo an®@end point. The location of the 
center and enc points agenend upon the specified vector 
type and suoolied center and end point parameters. 
The parameters oassed for the center and end points of 
the arc are either relative or absolute values. The 
number and value of these parameters are determined by 
the vector tyce selected in the previous call to  set- 


vector(). is the center point iS not an equal dis@- 
tamce from the starting point of the are and the end 
coint, an arc will be drawn using one of the distances 


as the radius. The result iS a Straight line drawn 
from the ‘actual terminating point of the are to tne 
ema point. 


If the vector type is an absolute vector, the center 
ana end points will] be as given in the parameter J]1i1st. 
Autortincrement vector tyoes will cause the center and 
end points to have the same coordinate value as the 
Starting point for the designated autorwincrement coor- 
dinate. Under absolute vector tyoesSr parameters which 
fall outside the defined coordinate system wil] assume 
a value of the nearest coordinate within the defined 
system. 














ake ere 


If the vector type is a relative vector, the end point 
of the arc will be obtained by adding the endx, endy, 


and endz values to the starting point. The center 
point 18 then obtained by addina the centx, centys and 
centz values to the oreviously obtained endpoint. As 


with absolute vectors, autortincrement modes cause the 
center and end ocoints to have the same coordinate 
value as the starting point for the designated auto- 
increment coordinate. Under relative vector types, 
parameters which exceed onewhalf the coordinate range 
will be set to zero. 


Arcs cannot be drawn by any of the four incremental 
vectors. 


ODMGNOSTICS: 


All errors wil! be orinted on the PDP-11 termina] 


screen. 
ERROR CAUSE ACTION 
E=] Routine nas been called Return 
outside a drawele() block 
E=-2 No more space available Return 
in disolay list 
E=-3 The draw direction was not dir =C 
defined as €C or CC 
E= {4 3D not defined Return 
B= 15 The x value was outsof*bdounds x = xmin 
or xmax 
Oreo. 0 
E=-16 The y value was outcof*bounds y = ymin 
or ymax 
lip ae eR, 
E=-1/7 The z value was outcrof*tounds Z = zmin 
or zmax 
Sie ev 
E=19 iibegal anc i9Sstrwetion Return 
from incremental vector 
Sizseo° SEE: 


circle, setvector 


tele 











olink blink 


NAME $ 
blink = blink the entire pvicture or the specified 
object or elements 
Syuesis: 
Mine leactioOn»snum,”"objname”,"elel™,"elec",s000 "elelo”)> 
iaceract ion: ON / 0} blink 
OFF / 00 Setoye) (ej! ia 2 ioral eye (e 1 elle 
ac wn uim . Feces 00 Srcture 
Osi 7 = object 
= 10 elements 
To blink the entire picture: 
DlinxCaction, PIC); 
Tomo 4 Specific object: 
blinkCactton,OBJ,"objname"); 
To See elements of a specific object: 
Him cactionsnum, OOjmame’ >, -elleley, Elec 7...) 
Bese iIPTIONs: 


The blink mode for the entire oicture, a single oo- 
ject or any number of elements of a specific object, 
Canoe turmed on or off. 


Modifying the blink mode of an object affects all eles 
memts tinked to that object. 


The parameter ‘rum! specifies the number of element 
Mames oeing eassed in this routine and can vary 
between 1 and 10. 


DYAGMHOSTICS: 


Al] errors wil! be orinted on the POP=-11 terminal 


screen. 

ERROR CAUSE ACTION 

B=5 Specified objname does not Return 
exist 


i 








blink 


Specified element does not 
exist 

Parameter ‘num' not -1 to 10 
Element not linked to 
specified object 

Improoer action value 


114 


blink 


Ski1o 
element 

num = 10 

Skip 
element 


action = OFF 











cget 


NAME: 


cget 


cget ~- get ASCII characters from the VG keyboard 


STOP Ssis: 
caet(buffer,lenath,xpos,ypoos)} 
Char *duffer; 
int length, 


mloat xpoSsryYpCos; 


Veo 1 LON: 


This routine allows for buffered 1mOuUr 


from the VG 


meyooard to be displayed on the display Screen and 
inserted in a user-supplied buffer. Parameters allow 


her athe. positioning of the display 
screen in absolute coordinates. The 
user=suoplied buffer must be specified 
ter *Penmeth'. 


buffer on the 
length of the 
in the parame- 


SEO iGetng cursor indicates the beginning of the 
buffer and the character S1Z7@. Characters may be 
entered into the buffer and onto the screen up to 2a 


maximum of either lei characters or the 


Contents mav be erased from the screen 


buffer by reoeated cntrica keystrokes. 


size of the 
sucolied user buffer, whichever is smaller. 


the user 
A C/R will 


terminate the inout string, delete the disolay of the 
buffer contents, and insert a '\Q' as the next charace- 
ter in the user buffer to indicate termination of the 


Sr rind. 


pict \aiemof the ASC menaracter.code for 


every key= 


board entry is listed on the following page. 


DIAGNOSTICS: 


Al] errors wil] be orinted on the PDPa-11 terminal 


Se nmeen.« 
ERROR CAUSE 


E<-9 Object limit exceeded 
E-15 Soecified xoos outz-of=bounds 


Le 


ACTION 
Return 


xpos = xmin 
or xmax 





Eger 


eae oe 


2oaly 


AleSoO TOoCE $ 


iget, 


OCT 


AL 


GO@DE 


000 
001 
002 
003 
004 
005 
006 
007 
010 
O11 
01ie 
013 
014 
OFS 
016 
017 
020 
021 
022 
023 
024 
025 
020 
0e7 
030 
031 
032 
033 
034 
ED) 
036 
O57 
040 
O41 
042 


specified yoos out-of=-bounds 
Either ie! characters entered 
or user buffer JTimit reached 
tfget 
VG 
CHARACTER GENERATED KEYBOARD 
SYMBOL SYMBOL 
NULL (i1qnored) 9? ctrl 
SO lastace Nait< ATetr | 
STX (i1qgnored) Beetrt 
ETX (1anNOoOred) Cactrn | 
BOT (iaqnored) Dwetr 
ENQ (i1anored) eke 
ACK (i1anored) Fasc top| 
BEL (19Q9nNoOred) G etri 
BS B 
HT (LF, cent) [. seetare 
ik Bs 
v1 (top, cent) Kae ur) 
aig (Hoon Wet to re tn 
NL COR, tb) CR 
SE (ianored) Nate tr 
Sl (1aqnored) One tr 
BEE (clear queue) Pac tc 
DC i (-LF ) Give tr 
DCe (-SZ) ee teal 
bes (+SZ) Sc tr 
DC4 (terminate) Le eateies) 
NAK (iomered) vies 
SYN (janored) Wi fete ty | 
ETB (ignored) Woetrl 
CAN (ignored) OT eitars| 
EM (ignored) ree 
Sue (ianored) FE oh Oe 
ESC (escape) Petr 
FS (ianored) VN ctr 
GS (ignored) Jeeta 
RS (iaqnored) A Ete 
US (i qnored) sere Cp 
Space sp bar 
! l shift 
" 2 shvrt 


ypos 


Wait 


€gert 


ymin 


or ymax 


for CR 
or CNIRL@-A 






C Gest 


Q43 
O44 
045 
O46 
047 
050 
0S } 
05e 
053 
054 
055 
056 
057 
}60 
061 
06e 
063 
064 
065 
066 
067 
070 
071 
07e 
073 
074 
OMS 
076 
O77 
100 
101 
ia 
103 
104 
105 
106 
107 
yO 
1 
ie 
113 
114 
a5 
ae ee! 
er? 
120 
cl 
ara 
123 
124 
reat 
126 


SK A 


+ * tN = BO 


4 > 


<CwyMDWOVOZ ET KR QA THOANAMOVOATDTPEP BYBevvV itl Awe OONOUWESEWMW—ONs 


w= ve ee OON AW SW 


pr seer OOMONO NEW —- On 


STR OR TOMDMOVARdIDAPHYnNnes 


<x“ CANDO VDAO 2 


Shane 
Shirt 
shift 
Shirt 
shift 
shift 
shift 
shift 
shift 


shi tt 
shift 
Shani 
Sn he 


Snitet 
Shit ct 
tal Wee 
Shit 
Sian 
shift 
snift 
Share 
shift 
Shire 
Sint f © 
Shift 
shift 
Sinit t 
shift 
Sint tt 
Sinnet t 
shift 
Shier t 
shift 
shift 
shift 


eget 





C Ger 


lie / 
130 
1 
ee 
5 5 
134 
> 
136 
7 
140 
141 
14e 
143 
144 
145 
146 
147 
150 
ea 
loc 
E55 
154 
35 
alle 
157 
eid 
et 
l6ée 
163 
164 
165 
166 
Oy 
170 
el 
l7e2 
5 
174 
eas 
p76 
i 
24d 
24) 
ee 
243 
244 
245 
246 
e477 
a0 
can 
amie 


(Superscript) 
(subscript) 


| Pr ZF aN<xKE 


m 


(centered) 


SVOWN <mOxze D0 YL ~-- AN «cK x x <cCern70g00039 9 — eee TQ ~0 00 Tw 


(subscrioe.) 


Dis 


PM FaANXKX EK CAMMOVOZECKLNTHAMIN DES) PHL ON<xs 


shift 
shift 
shift 
shift 


shift 


SPace spec 


er OOnN CO VWI CW PY 


shift 
Spat t 
shift 
shift 
shift 
Shemtit 
Shen t 
shift 
shift 
Shower © 


Sseee 
spec 
spec 
ap Loh 
spec 
spec 
spec 
spec 
Sseee 


spec 


coer 





ece t 


(centered) 


(center dot) 


(blinking) 


CEY NSO AXGAOHWBWHY e | TYErIN-eH-OMHDADS At x-IdDcnrow>reO f%o4 v yf wd 7 


ele 


t-~ 


OOnN eT WLW one 


2erxunroanmooowreal prranxx F< CawnwnovdsZz er we 


shift 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
shift 
Shi tt 
shift 
shift 
Site 
Sihitet ec 
shift 
Shree 
Shit 
Siete 
Shi 1 & 
Shite 
Shit t 
shift 
Sanne 
spec 
spec 
spec 
spec 
spec 
Shy tt 
soec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
soec 
spec 


Seec 


spec 
SP ee 
soec 
spec 
spec 
spec 
Spec 
spec 
spec 
Spec 
spec 
spec 
spec 
spec 
spec 


spec 


cget 














cgert 


Sie i 


SA a eee 0 Ss 2 ean m€ 


lee 


KY YenNK «KM SK CANDO VO 


spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 


A spec 
DEL spec 


Sm fc 
shift 
Svat c 
smite 


cget 





charele charele 


NAME: 


charele = displays an ASCII character string 
on the Vector Genera] 


Ser sts: 


charele("“elename",charptr,sizerwdir,slant,xpos,-ypos); 


int size: SZ / 00900 use previous character size 
Si wes 00.0 size = 100 col x 60 lines 
SzZer7 0120 size = 81 col x 41 lines 
S257 30 140 Sixe = 60 col x 30 lines 
SZ4 / 0160 size = 32 col x 16 lines 

limtceewcyr : HOR / 0000 write horizontally 
VER / 0200 write vertically 

Waites lant SLNT / 00 slant characters 
NSLNT 7 O1 no slant characters 


theat xo00S, yoos; 


xpos: VGREL = to output characters relative 
to the present beam position 
the parameter xpos should be 
reolaced with VGREL and the 
parameter ypos omitted. 


DESCRIPT h@N: 


This routine disolays the MSGIN- character String, 
specified by charptr,r on the vector general screen. 
The characters can be output by specifying the desired 
coordinate starting point (xpos-ynos) or by outputting 
the string relative to the oresent beam location. The 
symbols available include formatting symbolsS and. an 
extended character set. These can be included in any 
character string by including the proper identifying 
symbols. The character string formattina symbols are: 


KEYBOARD FORMAT 
SY¥BOL 
4 a) backsoace: moves back one character space 
BA line feed, position center screen 
#B line feed 
8C position at top center of screen 
#1) position at too left corner of screen 
#E carriage control, line feeg 


Kas 











charele 


charele 
ae ianored 
#G 1anorea 
4H special character 
a] neg. line feed; moves up one line 
tJ cGecreases current character size by one 
HK Increases current character size by one 


Due to the extenaed character set available onthe 
vector general, all special character symbols are prea 
ceded by a pound siaqn. In order to have a@ pound sign 
apoear on the screenr two pound signs (##) must appear 
im the character string. A list of the special ehar= 
acters available are listed on the next page under 
Extended Character Set. 


DIAGNOSTICS: 


All errors will be printed on the POP-11 terminal 
screen. 
ERROR CAUSE ACTION 
E=-1 Routine has been called Return 
within a drawele() block 
E=-2 No space available in Return 
disolay list 
E=-4 Incorrect ASCII character symbol None 
found in character string 
a Th Duplicate element name Return 
E=-8 Maximum number of elements Return 
exceeded 
E=15 Soecified xpos outcofsbounGdsS xpos = xmin 
or xmax 
E-16 Soecified ypos outsrof bounds yoos = ymin 
or ymax 
B= 55 Improper ‘wodir' parameter write = HOR 
E-36 Improper 'slant' oarameter slant = 
NON 
B= 37 Imorcper ‘size’ oarameter size = $24 


b22 





charele charele 


Extended Character Set 


DATAMEDIA 
KEYBOARD CHAR AGa Et 


SYMBOL 
#space 
% | 
3" 
gl 
as 
2H 
#& 

g! 


a ( 


ue Yh > =< GS =] = 4 


at 
bd 
~~ 
© 


t+ > 
4, a 
Pe, = 
= = 
a/ “t 
#0 ° 
#1 # 
42 ¥ 
43 C 
44 € 
#5 “ 


ae 





charele 


charele 


On ?P? CC 


#6 
a7 
#8 
49 


4 6B¢e dre cq vo 
>. 


= 


Oe ON 


124 


ce eer tee 6 











charele 


charele 


}%e'e@weeuwowe e444 NK KCK VTA FREY SL 


b 


e 


n 


0 N 


ie 





charele charele 
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circle circle 


NAME 


Girpcle ~ draw a circle 


Sy MDPSIS: 


e-dimensional coordinate system 
VR/VA 3 circle(dir,centx,centy); 
VRX/VAX: cirele(dir,centy); 
VRY/VAY: circle(dir,centx); 
VIRZ/ Va7Z ° not allowed 


3-dimensional coordinate system 
VR/VA 3: circle(dir,centx,centy,centz); 
VRX/VAX3 circle(dir,centy,centz)} 
VRY/VAY: cirele(dir,centx,centz)} 
VRZ/VAZ: circle(dir,centx,centy)? 


tee oir: Clay O10 clockwise 
CC / 004 counterw-clockwise 


froat Centx,centy,centz; 


PESCRIFTION: 


A circle is drawn from the oresent beam location about 
a center point. ine locattvon “of the center ooint 
depends upon the specified vector tyoe and supplied 
center ooint oarameter. The parameters passed for the 
center point of the circle are either relative or 
absolute values. The number and value of these parame 
eters are determined ody the vector type selected in 
the previous call to setvector(). 


iieeeerme vector tyoe is an absolute vector then the 
Gemrer Ocint of the cirmcle will be as given in° the 
Darameter list. Autostincrement vector tyoes will 
Cause the center ocoint to have the same coordinate 
value as the starting point for the designated auto- 
increment coordinate. Under absolute vector types, 
parameters which fall outside the cgefined coordinate 
system will assume a value of the nearest coordinate 
within the defined system. 


If the vector tyoe is a relative vector the center 
point will be obtained by adding the centx,s, centys and 
ent z values to the starting coinmt. As with absolute 
vectors, autotincrement modes cause the center point 
to have the same coordinate value as the starting 
Ssoint for the designated autosincrement coordinate. 


ent 








Grre le circle 


Under relative vector types, parameters which exceed 
one=half the coordinate ranae will be set to zero. 


Circles cannot be drawn by any of the four incremental 


vectors. 
DIAGNOSTICS: 
All errors will be orinted on the PODPe-11 terminal 
screen. 
ERROR CAUSE ACTION 
E-1 Routine has been called Return 
outsice a drawele() block 
E-2 No space available in Return 
display list 
Eas Oraw direction not defined op = 
as either C or CC 
E={1 3D not defined Return 
E-15 The x value was outcrofsbounds x = xmin 
or xmax 
erp he 1, 
E-16 The y value was outrof=bounds y = ymin 
or ymax 
or 0.9 
E-17 The z value was outrof=bounds 2 = zmin 
or z2max 
opp Ol rs8, 
E-19 ITliegal circle instruction Return 


from incremental vector 


mies SEE? 


arc, setvector 


a3 





Clrhat ee ha.t 


NAME s 
clrhit = clear picture/object/element ) Vellsmeteveta | laniiis 
SYNGESIS: 
elenit(num, “objname","elename”"); 
iq@eeenums FIC / OO clear all element lightpen hits 
OB 7: =] clear ligqghtpen hits on al] 
elements of specified object 
ELE / +1 clear ligqhtoen hit on specified 
element of specified object 
To clear all elements of lightpen hits: 
elirmiyt (PIC ); 
To clear all elements of object ‘tree’: 
errpit CObw, tree”); 
To clear element ‘branchS' of object ‘'tree': 
GlinmmtcetLe, tree”, branchs J; 
DESCRIPTION: 


This routine clears lightoen hits on a single element, 
group of elements, or all elements. [fj PIC ys soccer] 
fied, all elements are cleared of lightpen hits. Lf 
OBJ is specified, all elements attached to the speci- 
fwea object are cleared of lightpen hits. ite BE eos 
specified, only the indicated element of the specified 
Oemect 1s cleared of a liaqntoen nit. Invalid oarame- 
ters will result in no action deing taken. 


DIAGNOSTICS: 


All errors will be printed on the PDPe-il terminal 


screen. 
ERROR CAUSE ACTION 
E=5 Indicated objname does not Return 
exist 
E=-6 Indicated elename does not Return 
exist 
Eee? Element not linked to Return 


soecified object 


eo 








coordsys coordsys 


NAME : 


coordsys = define user coordinate system 


Ser sis: 


coordsysldimsminx,s,maxxs,minysmaxy (l,minz,maxz] )3 
int dim: e2@or 3 


float minxsmaxxsminy.maxy,minzrmaxz} 


WEserRiLPTION: 


Defines a two or three dimensional cartesian coordi- 
mate system, of any scale, for tne user. The parameter 
"dim' specifies the number of dimensions required. If 
"dim' is 2 then only the range of x and y need to be 
specified. 


minx must be strictly less than maxx. 
miny must be strictly less than maxy. 
Mine must be strictly less than maxz. 


All subsequent user coordinate values are interoreted 
according to this user defined coordinate system. 


if veoordsys() 1s Not callea by the user the default 
values will be taken. The cefault coordinate system is 
three dimensional with x, yr 2 ranging from -100.0 to 
100.0. All coordinate values received will dpe inter- 
oreted accoraing to these default values unless the 
coordinate system 1s redefined by the user. 


DimewOSTICS: 


Any values which fall] outside of the defined coordi- 
nate system will oroduce an error message specifying 
which coordinate value was outwof=bounds. If the 
value was an absolute coordinate, the nearest coordis 
nate within the defined coordinate system wil! be 
assumed. If the value was a relative value that was 
outrof=bounds, a value of zero will be assumed. 


Al] errors” will be printed on the PDPH-11i terminal 
screen. 


0 








coorasys GCOOrGSsYS 


ERROR Case ACTION 
e=) |} Dimension not svoecified as Return 
e€D or 3D 


Pont 





ee 





copyele convele 


NAME: 
copyele = specify additional names to be used 
in referencing a specific element block 
SYNOPSIS: 
copvele(num,"elename","namel","namec",cceer' Nnameld"); 


int Num? feta 10 


BESGrRIPT (ON: 


This routine allows the uSer to give several unique 
names to a specific element clock. In this manner, a 
user can link one element to an object several times 
amcmmean uniquely reference each occurrence of the 
element within the object. 


The parameter 'num' specifies the number of element 


names beinaq oassed in this routine and can vary 
between 1 and 10. 


DIAGNOSTICS: 


Migmwerrors will be printed on the PDP=1! terminal 
SCREEN « 
ERROR GA Se ACTION 
E=-6 Soecified elename does not Return 
exist 
E@/7 Duplicate element name Skip 
element 
E-8 Maximum number of elements Return 
exceeded 
E-18 Parameter ‘num’ mot i> te 10 num = 10 
poe) SEE: 


drawele, obdject 


Vie 








cursor cursor 


NAME 


cursor - activate/deactivate display of specified 
device cursor | 


SYNOPSIS: 


cursor(dev,action);3 


int dev: LPEN / QO liaqhtpen 
TRK / Of trackbal | 
Jey 7% 02 joysticx« 
ice act ion: OFF / QO Cie nee URS O CuCl IIS © lisiy ares 
ON / O1 CUrME CURSOR sad1Se lay. on 
DESCRIPTION: 
This routine will activate/deactivate the aisolay of 


the soecified device cursor depending on the specified 
"action Value. 


The trackball and joystick cursors are displayed as 
Smx img Oo1US Signs. The trackball cursor is two 
dimensional and may he moved alona the XY plane. The 
joystick cursor 18 drawn two dimensionally but can 
move in all three dimensions. As the joystick cursor 
moves along the Z axis its intensity cueing 1s affect= 
ed. Both trackball and joystick cursors may be moved 
without being disolayed. 


The jightoen cursor is a small none=blinking octoqon. 
ee is drawn in two dimensions and can only nove aliona 
the X-Y plane. The lightoen may only be noved while 
beina disolaved. Lightoen cursor movement may be 
accomolished in one of two speedSs, cGcepending upon 
whetner the lightpen sense switch 15 On. 


DIAGNOSTICS: 
Al] errors wil] be orinted on the PDPeil terminal 
screen. 
ERROR CAUSE ACTION 
mae Imoroover ‘action’ value Return 
E=-27 Imorooer ‘dev’ number Return 


US) 











a vat dia} 


NAME : 


dial =~ return value of specified dia} 


SYNOPSIS: 
dial (num)? 
Tat mum: 1-10 


double dial()3 


PeoenlPTiON: 


This routine returns to the user a double precision 
weeemr rom =1.0 to +1.0 of the specified dial. A zero 
(0) is returned to the user if an improper dia) ‘'num' 
is see@e; fied. 


To obtain the double orecision value from this routine 
tae fUMECCION dCeclaration “double dial()7" must be made 
in the users program. 


OIAGNOSTICS: 
Ay] errors wil) be printed on the PDPHe1l terminal 
screen. 
ERROR GAUSE ACTION 
B= 25 Imoroocer dial ‘'‘num' Return 0.0 


134 





aGisolay display 


NAME 3 


Gisolay = activate/deactivate display of the entire 
Dicturer an objects, or an element 


Senor Sls: 


Gisplaylaction,tynpe,"“objname","elel",...-,"elel0"); 


late action: OiNirey £Ot turn display on 
pe 7 00 PUrRMead1SD lay voce 


mt tyoe: Pre 7 00 entire picture 
OBJ / -]| specified object 
1 = 10 individual elements 
To activate disolay of entire picture: 
disolay(ON,PIC); 
To deactivate display of an object: 
Gispiay (OPE, O08), ob )name J: 


To deactivate display of 3 elements in an object: 


disolay(OFF,3,"“objname","elel","elee","ele3"); 


BeceRIPTION: 


tersSuroutime will activate or Geactivate the displ ay 
of the entire picture, an objectr or elements within 
an object depending upon the Tae) On mca raneter . 
Unlike the erase() and remove() routines, this routine 
does not affect the elementrobjsect relationshios, but 
simoly turns the display of 1tsS Oarameters either on 
Olea @ tit. The routine should not be confused with the 
vapicture() routine which must be called to initiate 
the disolay of elements. 


BTSENOSTICS: 


All errors will be orinted on the PDPe-1i1 terminal 
screen. 


ERROR CAUSE ACTION 

B= 5 Soecified objname not found Return 

E=*6 Soecified element not found Skip 
element 


135 








disolay display 


E=-18 Parameter '‘type' not =1 to 10 tyoe = 10 
E-2e Element not linked to Skip 
specified object element 
miso SEE $ 


vgoicture, erase, remove 


ye 





drawele drawele 


NAME: 

drawele - start a draw element block 
SYNOPSIS: 

drawele("“elename"); 
DEeSeRIPTION: 


Paes routine soecifies the beainning of a draw element 
Galfoe kK. It associates a unique name with the group of 
gawd IAastructions that fall in between this call anda 
call to encele(). The resulting picture segment will 
then be referenced by the name scecified as the ele- 
ment name in this routine. 


A user may want to repeat a specific element block 
Structure several times within one object. Instead of 
specifying several element blocks which describe the 
Same structure a user can indicate a group of names 
whicn refer to one snecific element block. These 
unique names each referring to the same structure can 
then be linked to an object, and each can be uniquely 
referenced. This association of several names with one 
element can be accomplished by the routine copyele(). 


DIAGNOSTICS: 


Alleerrors will be orinted ‘om the POP=-i1 terminal 
screen. 
ERROR CAUSE ACTION 
E-1 Routine has been called Return 
within a drawele() block 
E-e No space available Return 
jorarsoOlay list 
E-7 Duplicate element name Return 
E-8 Maximum number of elements Return 
exceeded 
Pls oe E : 


copyeler object 


a al 





endele 


endele 


NAME 3 
endele = end of the current element block 

SYNOPSIS: 
endele(),; 

DESCRIPTION: 
Soecifies the  “Cerminativomuot a list ofr Craweinstruc= 
tions describina a snoecific element. The picture seg- 
ment described by a grouo of draw instructions that 
fall between a drawele() and endele() call will be 
referenced by the name specified in the drawele() 
Calls 
A new element block cannot oegin until the previous 
block has been oroperly terminated by a cal] to en- 
dele(). 

DIAGNOSTICS: 


This routine must be called to oroperly end a draw 
element block. If a block 1S not properly terminated 
orior to the beginning of a new element block, al] 
drawele() calls will be ignored and any draw instruc 
tions that follow will be associatedq with the element 
blo@k that has not been terminated. 


Al) errors wi) be printed on tne PUPeMW11 terminal 
screen. 
ERROR CAUSE ACTIQN 

E=-1 Routine has been called Return 


outsiage a drawele() block 
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erase 


NAME: 
erase ~ erase the soecified portions of the picture 
SYMOPSIS.: 
erase(nums"objname","elel","“ele2",....,"elel0"); 
imc mum < PIC / 00 all elements 
OBJ 7 =} all elements within specified 
object 
1 = 10 soecified elements within 
soecified object 
To erase the entire picture: 
erase(PIC); 
To erase a specific object: 
erase(OBJ,"*objname"); 
To erase elements of a specific object: 
erase(num,"objname","elel","eleo",..)3 
DESCRIPTION: 
Ve emtire picture, soecified obiect OF the listed 
elements of a soecific object, will be erased from the 
vector genera] disolay screen. The elements sti] 


exist. To redisolay any oortion of the erased picture, 
the aoorooriate elementrobject linking must again ove 
done by the user. 


The parameter ‘'num' specifies the number of element 
names being passed in this froutine and may vary 
between 1 and 10. 


DEAGNOSTICS: 


All errors will be orinted on the PDPe-11 terminal 
screen. 


ERROR CAUSE ACTION 
E=5 Soecified objname does not Return 
exist 
E=-6 Soecified element does not Skio 
exist element 
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erase 


erase 
E-18 Parameter 'num' not -1 to 10 num = 10 
E-ee Element not linked to Skip 
specified object element 
m_SO SEE: 


remove, disolay, object 





SaRoem SS errormsg 


NAME: 

errormsg = orint error messages on POP=11 terminal 

screen 

SYNOPSIS: 

errormsaqlaction); 

tence act ron $ Oar 04 ODrint error messages 

OFF / QO do not orint error messages 

DESCRIPTION: 


All error messages wil! automatically be orinted on 
the PDP-11 terminal screen. The user can control the 
SEerntineg of error messages during any portion of a 
erogrem Oy calltngo this routine. 
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fget 


fget 
NAME: 
fget =- get a floating point number from the VG 
keyboard 
SYNOPSIS: 
toe (numsxoos;,yoos]) ); 
™m™t mums ABS / 01 absolute coordinate indicator 


float xoos,ypoos;3 (x,y) absolute coordinate 


To return a floating point number and begin inout 
disolay buffer at (50.0,75.0) absolute: 


maetmcao5,50.0,75.0); 


To return a floating point number and begin input 
display buffer at (xmin,ymin) absolute: 


faet(); 


DESCRIPTION: 


This routine returns to the user ai floating point 
number from the VG keyboard. The routine is similar 
Memoett() and in fact uses getf() to accomplish its 
task « 


The ootional ocarameters allow the user to position the 
input disolav buffer anywhere on the display screen. 
liimese xODo0s and '’yoos' parameters are absolute floatina 


SO1nt coordinates. iet NO parameters are given the 
inout buffer will begin at (xmin,symin). Coordinate 
Oarameters which fall outside the defined coordinate 


system will assume a value of the nearest coordinate 
within the defined system. 


The input disolay buffer is drawn with the help of a 
cal] to the cget() routine. The input disolay buffer 
has a2 maximum size of 29 characters before an error 
message 1s displayed. 


To obtain the floating ovoint value from this routine 


the function declaration "float fget();" must be made 
in the users crogram. 
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fget foqet 


DIAGNOSTICS: 


All errors will be printed of the POP-1i terminal 


screen. 

FRROR CAUSE ACTION 
E-15 Specified xpos outrof=bounds XPOS = xmin 
or xmax 
E-16 Soecified yoos outof=bounds yPos = ymin 
or ymax 
E=-33 Buffer limit of 20 characters Wait for CR 
reached or CNTRL@=A 

mes) SEE: 
Vaet, coqet 
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fsman femen 


NAME: 


fsman = check function switch depressed 


SYNOPSIS: 
fsman(num); 


int num: QO =- 31 


Pesce eTeTloNs 


This routine checks the status of the specified funce- 
tion switch and returns a one (1) if depressed and a 
zero (0) if not deoressed. Unlike fstog(), lamps are 
not lighted by this routine and a one is returned only 
so long as the Switch is ohysically depressed. 


It iS not recommended that both fstog() and fsman() be 
used in the same program. Due to the ooeration of the 
routine fstog(), if both routines are used the lamp 
Status on switches queried by fsman() should be disre- 
garded. 


A zero 1s returned i f an improper function switch 
"num is soecified. 


DEAGHOSTICS: 
Piilweerrors wil] bet printed | on the POP-11 terminal 
screen. 
ERROR CaS b ACT Gh 
E=23 Improoer function Switch Return 9 
‘num’ soecified 
meow SEE Ss 


fstog, lamp 
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f sito'9 


fstaq 


NAME: 
fstog = check function switch toggle 

SYNOPSIS: 
fstog(num); 
int num: 0 = 31 

DESCRIPTION: 
leanics Pouttme eChecxns the spoeci fied funmctaiom Switen ana 
returns a one (1) and lights the apooropriate lamp on 
the odd (lst,3rd,5th,...-) depressions of the function 
sa veoh. ime cretunm value and lamps status remain the 
Same until the next even (2nd,-4th,b6th,.ee-) deoression 
of the functicn switch whereupon a zero C03 is reo 
turned and the lamp extinauished. 
It iS not recommended to use botn fstog() and fsman() 
routines in the same program; however, if ooth are 
used, disregard the lamo status of function switches 
Queried by fsman(). 
A zero 18S returned tf an improper function switch 
"nom 1S soeci fied. 

DiaGNOSTICS: 
Be) errors wil] be orinted on the POPe1i!1 termina) 
screen. 
ERROR CAUSE ACTION 
E-23 Improper function switch Return 

Tmum = SOeci tied 
mimeoo SEE; 


fsman, llamo 
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iget 


Toet 
NAME 
1get = get an integer from the VG keyboard 
SywnorPSis: 
iget ( (num, xoos,voos) )3 
lotenumse, ABS / 01 absolute coordinate indicator 


tiloat xoo0sS; yYoOoSs; (x,y) absolute coordinate 


To return an integer and beain input display buffer at 
Ciezos0, 1) 20) absolute: 


Vaet (AGS, —-c5.0,17 250); 
To return an inteaqer and begin jinout display buffer at 
(xminrsymin) absolutes 


1aet(); 


DESCRIPTLON: 


This routine returns to the user an integer from the 
VG keyboard. the rout imewises im lant omoce tc 1.0) sonic ual iim 
fact uses geti() to accomplish its task. 


The optional oarameters allow the user to position the 
input display ouffer anywhere on the disolay screen. 
The 'xpos' and 'yoos' parameters are absolute floating 
Point coordinates. If mo parameters are agiven the 
input disolay buffer will begin at (xmin-symin). Coor- 
dinate oarameters which fall outside the defined coore- 
dinate system will assume a value of the nearest coor- 
dinate within the defined system. 


The input disolay buffer is drawn with the help of a 
call to the cget() routine. The input disolay ouffer 
has a maximum size of 20 characters before an error 
message is displayed. 


DIAGNOSTICS: 
ae) errors will he orinted on the POPa11 terminal 
screen. 
ERROR CAUSE ACTION 
E=-15 Soecified xpos out of bounds KxOOS = xmin 


or xmax 


146 











1get 


ao be 


E=o5 


meow SEE > 


fget, 


Soecified ypos out of bounds 


Buffer 
reached 


eget 


limit of 20 characters 
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iget 


ypos = ymin 

or ymax 
Wait for CR 
or CNTRL=@A 





intoffset intoffset 


NAME s 
Intoffset - object intensity offset 
SYNOPSIS: 
inter fsetC"objiname",val );3 
fimoat val: Ur Ot On 1 a0) 
BeseRIPTIONs: 
The intensity ranae of the specified object is deter- 
mined by the parameter ‘val'. If ‘val’ 1s oney the 
maximum intensity range is achieved. If the value 1s 
zero, the intensity 1S constant and the image has no 
deoth-cueing. 
DEAGNOSTICS: 
All errors will be oprinted on the POPel1l1 terminal 
screen. 
ERROR Seley ACTION 
E=-5 Soecified object does moe Return 
exist 
E=-30 Parameter "val “mot 7-00 mtomr. 0 Return 
Ale SEE ° 
intscale 
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intscale 


NAME 3 


intscale 


Intscale = modify object intensity scale 


SYNOPSIS: 


intscale("objname",val,cut); 
float val: Os07 tou toad 


mat cut: Ueore | 


BBoCRIPTION: 


fnew ymtensity fancde of an ~object, “which “aqives a 
three-dimensional object its depth cueing, 1s deter-~- 
mined by the oarameter ‘'val'. The range of 'val' is 
from zero to one. If ‘val' is one the maximum intensi- 
ty ranqe 1S obtained, if it is zero the object has no 
deoth cueing. 


The parameter 'cut' provides for the use of a screen 
cuteoff plane. If the value of ‘cut’ 18 one then the 
cutroff plane provisions are in effect. If the value 
is zero there will be no screen cuteroff plane. 


DieeaGNOSTICS: 


All errors wil] be erinted on the PDP-11 terminal 
screen. 


ERROR CAUSE ACTION 
E-5 Soecified odjname does not Return 
exist 
ca 5) Parametec ‘val' not 0.0 to 1.90 Return 
E=s1 Parameter ‘cut’ not 0 or 1 Return 
Meoo. SEE > 


intoffset 
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lamp lamo 


lamp - light/extinguish specified lamo 


SYNOPSIS: 
lamp (num,action); 
int nums 0 =- 31 


Vac action: OFF / QO bUthshamo we it 
ON / OQ} turn lamp on 


DESCRIPTION: 


This routine lights/extinguishes the specified lamp 


deoending on the spnecified ‘action’ oarameter. An 
faction’ value of OFF will extinguish the specified 
llamo, while a value of ON will light the aporopriate 
lamp. An improper ltamo ‘num’ or ‘action’ will result 


ln Memaeryon cCeina taken. 


OEAGNOSTICS: 


All errors will be orinted on the PDPe-11 terminal 
screen. 
ERROR CAUSE ACTION 
E=25 Imoroper llamo ‘num! specified Return 
E24 Imoroper ‘action’ value soecified Return 
ALSO SBE: 
fstog 
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Ightpen Ightpen 


NAME ¢ 


Ightpen = set lightpen sensitivity of 
the picture,object or elements 


SYNOPSIS: 


Ightpenlactionsnum,"“objname","elel","eleo",.ecestelell"); 


wat action: Git 7 7:0} set ligqhtpen sensitivity 
ORF I7 00 clear liahtpen sensitivity 


Vat mem: PIC / 00 picture 
GB 7 == 1 object 
1 =- 10 elements 


To set sensitivity of the entire voicture: 
Ightpen(action,PIC); 

To set sensitivity of an object: 
Ightpen(action,OBJ,"objname"); 

To set sensitivity of elements of a specific object: 


lomtoen(action;num, ebiname+,.elel, elec 7.) 


BEscRIPTION: 


The user can specify which picture segments” wil] be 
li gmeoen Sensitive. These elements designated as 
lightpen sensitive will be affected by liqhtpen ine 
teraction with the vector general disolay screen. 


The parameter ‘'num' specifies the number of element 
names peing passed in this routine and may vary from } 
Gort 0. 


OTAGNOSTICS: 


All errors will be printed on the POP-11 terminal 


screen. 
ERROR CAUSE ACTION 
E=5 Specified objname does not Return 
exist 
E=-6 Soecified element does not Si io 
exist element 
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Ilqghtoen 


Eis 
ee 2 


Beso SEE: 


penhit, 


Parameter ‘num' not ol 
Element not linked to 
soecified object 


to 


Giri wt 


eae 


10 


lghtpen 


num = 10 
Skip 
element 





line 


line 
NAME 3 
line = draw a line 
SYNOPSIS: 
e-dimensional coordinate system 
VR/VA : line(parx,pary);3 
VRX/VAX:? lineloary); 
VRY/SVAY3 line Coarx); 
VRZ/VAZ: Not allowed 
3-dimensional coordinate system 
VR/VA : lineloarx,pary,soarz); 
VRX/VAX? linefoary,parz);3 
VRY/VAY: line(oarx,oarz);3 
VRZ/VAZ: line(oarx,popary); 
ileeat = oarx,Oary,Oar 2: 
DESeRIPTION: 
A line is drawn from the present beam location to a 


Bocttiom (x*y,z). The location of (x,y,z) denoends 
upon the vector tyoe and the specified parameters... 


If the vector type is absolute, the location of 
(xryr2z) will be (parx,oary,parz). If an autoe- 
increment mode is in effect, the designated auto- 
increment coordinate is left out of the parameter list 
and 1s incremented by the designated increment to find 
the termination point of the line. Under absolute 
vector tyoes, poarameters which fall outside the de- 
fined coordinate system will assume a value of the 
nearest coordinate within the defined system. 


If the vector tyoe is relative, the location of 
(x,y,z) will be the present beam location plus’ the 
specified parameter values. As with absolute vectors, 
autoztincrement modes do not specify the designated 


autorincrement coordinate HAL the parameter iSite 
Under relative vector tyoes, parameters which exceed 
one-half the coordinate range will be set to zero. 


DIAGNOSTICS: 


Al] errors will be printed on the POP-11 terminal 
screen. 


ee) 











| 


line 


Pama SEE: 


CAUSE 

Routine has been called 
outsiae a drawele() block 

No space available in 
display list 

Parameter parx outrof=bounds 


Parameter pary out7of-bounds 


Parameter par2z outcrof-bounds 


SeGVECctor 
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line 


ACTION 
Return 


Return 
oarx = xmin 
or xmax 
ore 0) 4) 
pary = ymin 
or ymax 
or 0.0 
oparz = zmin 
or 2max 
Or 0.0 





manint 


manint 


NAME: 
manint - Clear or return manual Intenrruot eount 
SYNOPSIS: 
manint(laction); 
Time ae t 10M $ CLEAR / QO Set —count ctonzero 
COUNT / Q1 return count 
DESCRIPTION: 


This routine either returns the present value of the 
manual interrupt count or resets the count to zero. 
Each time the manual interrupt fumetiOn “switeh 7s 
depressed the manual interrupt count 15S incremented dy 
one. 


An ‘action’ value of COUNT will return to the user the 
opresent manual interrupt count, while a value of CLEAR 
wil] reset the count to zero. An improper ‘action' 
value will result in returning a value of zero but not 
affecting the manual interrupt count. 


PERGNOSTICS: 


Ae errors wil] be printed on the PDPel11l terminal 
screen. 

ERROR CAUSE ero ON 

E=24 Improper ‘action’ value Return 0 


ie) 





nove Move 


NAME: 


move = move to the specified location 


Swue@rsis: 


e-dimensional coordinate system 
VR/VA 3: move(parx,pary):; 
VRX/VAX: movel(pary);} 
VRY/VAY$ moveloarx); 
VRZ/VAZ: not allowed 


S-dimensional coordinate system 
VR/VA : movel(vdarx,oary,parz)} 
VRX/VAX3 movelvpary,parz)} 
VRY/SVAY: moveloparx,parz); 
VRZ/VAZ3 moveloarx,oary); 


meat DParx,;Oary,Darz-: 


MESeRIPTION: 


The beam is moved from the oresent position to 2 posi- 
tion (x,yrZ2). The location of (x,»y,2z) depends uoon 
the vector type and the specified parameters. 


I f the vectcr tyoe 18S absolute, the location of 
(XyyepZ) will be (Cparx,cary-perz). i an auto- 
increment mode is in effect, the designated auto- 
inmcerement coordinate is left out of the parameter list 
and 1S incremented by the designated increment to find 
the termination point. Under absolute vector types, 
parameters which fall outside the defined coordinate 
System will assume a value of the nearest coordinate 
within the defined system. 


If the vector tyne 1s relative, tnewmnrrocat lon mo tf 
(xe,yr~-z) will be the oresent beam location plus the 
specified parameter values. AS with absolute vectors, 
autoztincrement modes do not specify the designated 
autotinerement coordinate i1n the oarameter Ines t 
Under relative vector types, parameters which exceed 
onewhalf the coordinate range will be set to zero. 


DeewOSTICsS: 


All errors will be printed = on the PDP-11 terminal 
screen. 


neue, 








move 


Mimo SEE: 


CAUSE 

Routine has been called 
outside a drawele() block 

No space available in 
display list 

Parameter parx outrof=bounds 


Parameter pary outrof*bounds 


Parameter parz outrvo0f*bounds 


setvector 
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MOVE 


ACTION 
Return 


Return 


o9arx = xmin 
or xmax 

or 0.0 

pary = ymin 
or ymax 

ors 0.90 

parz = zmin 
or 2max 

or 0.0 





as 
= 





obyect 


object 


NAME s 
object - link elements to specified object name 
SYNOPSIS: 
Sompect (num, “Objmame”", elel' selec", cecer eleld"); 
int num? | ee 8, 
DESCRIPTION: 
Associates with the named object each of the listed 
elements. This picture segment, or element grouping 
will be referenced by the object name specified in 
this routine. 
Every element must be linked to at least one object in 
order for yet to be displayed on the Vector General 
screen. A user can link one or more element names to 
an object. Elements can be linked to an odject by one 
or several calls to this routine. An element can be 
linked to several different objects, or one element 
may de linked several times to the same object. 
If an object or element has been erased from the 
display screen, a user can redisplay the cesired ob- 
ject or elements by again establishing the desired 
objyectrwelement association. 
The poarameter Valin’ specifies the numoer of element 
names being passed in this routine and may vary from 1 
Gomer < 
OIPAGNGSTICS: 
All errors) will be orinted on the POP-11 terminal 
screen. 
ERROR CAUSE ACTION 
E-6 Soecified element does not Skip 
exist element 
E-8 Maximum number of elements Return 
exceeced 
E-9 Maximum number of objects Return 
exceeced 
E-l1e Add element error Return 
E-18 Parameter ‘'num' not 1 to 10 num = 190 
E-e1 Add object error Return 
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ob) eet object 


E=-3e Element already linked Skip 
element 


MES 0S) a ae 


Grawele, copyeles, eraser remove 


[39 











NAME: 
offset - offset picture coordinate axis 
SYNOPSIS: 
orrset (xoff,yoftf); 
float xoffr,yoff: POR cro seul) 
DESCRIPTION: 
Esser outime will alter the oositiomima of the entire 
@scture on the display screen. Normal or default pic- 
ture ocostitioning 1s centered on the disolay screen and 
corresoonds to offset(0.0,0.0). Both the X and Y axes 
may be altered with this routine. Parameters outside 
the range 7-1.0 to +1.0 will result in no altering of 
@mmemsSOeCi1T1 ed cocrdinate axis. 
DIAGNOSTICS: 
Al] errors will be orinted on the PDP=-11 terminal 
Screen. 
ERROR CAUSE ACTION 
E-15 Socecified xoff value Skip X axis 
outsofs*bounds altering 
E-16 Specitlved pyortl. value Safer Vie ate 
outrsof=bounds altering 
mes® SEE? 
trans 
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pennhit penhit 


NAME: 


penhit =- determine if object/element lightpen hit 


SYNOPSIS: 
Senhit (num, “objname","elename® ) 3 


ie@teaum: OBJ / =| check penhit on odject 
ELE / +1 check penhit on element 


To check for liahtpen hit on object ‘tree's: 
pemhit (OBJ, “tree"); 


To check for lightpen hit on element 'branchS' of 
object ‘tree': 


Bemmit (ELE, tree”; ocranens  )- 


Pease hue? LON: 


This routine checks to see if an object or element 
within an object has had a lightpen hit. The routine 
returns to the user a one (1) if there has been a 
lightepen hit on the element or object, otherwise a 
zero (0) is returned. When testing for a lightpen hit 
on anobject only the first two oarameters are neces= 
Sary,r andaone is returned if any element within the 
Goummet hes hao a lightpen hit. 


The clrhit() routine must be called to clear an object 
Ormmelement of liaqhtoenm hits. Invalid parameters wil] 
result in a zero being returned to the user. 


EO: an element to register a liqghtpen hit’ the 
element's lightpen sensitivity must be activated with 
the Ightpen() routine and the lightoen, with the sense 
Switch selected, must be held over the element. 


CleGnGSstics: 


All errors will be orinted on the POP #11 termina] 


SOReen « 

ERROR CAUSE ACTION 

=> Indicated objname does not Return Q 
exist 

E=-6 Indicated elename does not Return 0 


exist 


orl 





penhit 


E=2e Element not linked to 
specified object 


foe SEE> 


Wentoen, cirhit 


lee 


penhit 


Return 0 





place Op lsce 


NAME: 
Olace = position object 
SYNOPSIS: 
place("objname",xabs,yabs [,zabs] );3 
float x80S,yYaDdSs,2ab0S; 
DESCRIPTION: 
The specifiec object, with all its elements, 18 posi-= 
tioned at absolute_location (xabs,yabs,zabs). 
The Z parameter 1S required only when the coordinate 
System 1s defined as three dimensional, and will be 
1Gnored if included under a two-dimensional system. 
DTAGNOSTICS: 
All errors will be orinted on the POP-11 terminal 
screen. 
ERROR CAUSE ACTION 
E=5 Soecified object does not Return 
exist 
Eeae Soecified xaos outrof=bounds xaos = xmin 
or xmMmax 
E-16 Specified yabds outrwof*bounds yaos = ymin 
or ymax 
E-17 Specified zabs outerof*bounds zabs = zmin 
or zmax 
Aloo” SEE: 


offset, trans 


oye) 





pes it 


Bes) t 


NAME: 
posit = return coordinate value of specified device 
cursor 
STNOrPSIS: 
Posit(dev,coord); 
int dev: LPEN / QO lightpen cursor 
TK -/ 071 trackball wecursar 
Ixy / Oe joystick cursor 
lite coord: Xe 7 20-0 x coordinate 
Nae y coordinate 
Z / Oe 2 €oordinate 
float posit(); 
DESCRIPTION: 


This routine returns to the user a 
value of the specified coordinate and 
value returned is a value within the 
coordinate system. 


Treating cont 


device. 


The 


user specified 


This routine will return the oresent position of the 


device cursor even though the cursor 
currently displayed. A coordinate value of 


may Mot 
zero 1s 


returnea if an improper parameter 1S received. 


bom obtain the floating ooint value fFom this 


tmeetumetion declaration “float coesiet 0) 
lamtne users crogram. 


PieAGHOSTICS: 


de 


routine 
must be made 


Al} errors will be orinted on the PDPeH1l terminal 
Screen. 
ERROR CAUSE ACTION 

Ese 7 Improoer ‘dev’ number Return 0.0 
E-28 Improoer ‘coord’ number Return 0.0 
E=-e9 Nom s0 with bFEN Or sta. Return 0.0 


pee oC. 


cursor 
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orinty 


Sprint Vv 


NAME: 
PGimey = formatted orintft routine tor VG@disp) ay 
SmnNiOPSiS: 
printv("elename",size,write,slant,xo00s,ypos, "format" 
Lv onG lames tc... ama! Olmes 
Vat Si ze: SZ / 00 use orevious character size 
SZ icy 0 £00 Sy Zee = 10 Caco lice Ou) nels 
Soe 7 O20 Stic eC w= or we On een) pies 
S750 7 Oo dG $1ze = 60 col x 30 lines 
SZ4 / 0160 $1ze = $2 col x 16 lines 
Wmeewrytes “HCR / 700 NOC Zones heorl mt )mc 
VER / 0200 vertical printing 
lame Slant: wolNT / 00 slanted printing 
NSEN T= / 20) No slanted printing 
float xpos,ypos; absolute coorainates 
A samole printed at (-25.0,-°19.0) absolute: 
printve test ",S74,HOR 7 SENT 7225-0), -10.0, 
"bravo[l{S] = “4d",bravo([5] ); 
DESGRIPTION: 


This routine is a formatted print routine similar to 
tiempo rimetf() iroutime  €xceoe Teoutoute 1s tol the VG 
@ysolay screen. The FoOuUtiIMne sna Comoimation “of the 
charele() and printf() routines. The routine uses the 
first 6 parameters as the charele() routine does mn 
positioning and initializing an element structure. 
Coordinate oarameters which fall] outside the defined 
coordinate system will assume a value of the nearest 
coordinate within the defined system. 


Unlike charele() the routine allows multiple calls 
uDOnN the same element, each ¢all updating the 
element's character string. The routine allows for 
formatted outcut strings of uo to 1900 characters be- 
fore an error messaqae 1s displayed. 


Fach new element declared in a printv() routine uses 
up S37 words of the available display J1st so care must 
be taken not to declare too many new elements in this 
routine. It should be remembered that an element may 


lors, 





Srinty Onpwntv 


be used repeatedly with this routine. 


Elements originally declared elsewhere as either vec- 
tor drawing elements or character drawing elements 
should not be used in this routine. In other words, 
element names found in this routine should be unique 
and Should not be found in other drawele() or 
Charele() routines. 


DIAGNOSTICS: 
All errors will be printed on the PDP-11 terminal 
screen. 
ERROR CAUSE ACTION 
a2 No more space available in Return 
disolay list 
E=-8 Maximum number of elements Return 
exceeced 
Ei) 5 Parameter xoos outsof-bdounds = al (A 
or xmax 
E-16 Parameter yoos out7of=-bounds y = ymin 
or ymax 
E=34 Formatted outout length CHhOpetor ise 
exceeds 100 characters 100 char 
E=35 Imorocer ‘write’ parameter write = HOR 
E=-36 Imoroper 'slant' oarameter slant = 
NSUNT 
E=-37 Improcer 'size' oarameter size = $Z4 
Beso. SEE: 
charele 
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oscale pscale 


NAME ; 


oscale = scale the picture 


SYNOPSIS: 
oscale(val); 


Tikoat yal : UaOw to. 1.0 


DeockR IPT LON" 


mis coutine will scale the entire picture. Normal or 
@efautlt picture scaltimg corresoonds to oscalAati.0). 
An improper oscale() oarameter will result in the pice 
ture scale remaining the same as before calling this 
routine, 


PeeeCNOSTICS: 


Al] errors will be printed on the PDPH-1il terminal 


screen. 
ERROR CAUSE ACTION 
E=30 Parameter ‘'val' not 0.0 to 1.0 Return 
pilaooe SEE : 
scale 
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refresh refresh 


NAME: 


refresh = change refresh rate 


SVuMePSIS: 


refresh(rate); 


mnt rate: 1 to 8 


DESCRIPTION: 


This routine will chanae the refresh rate of the vG 
display screen. Normal or default refresh rate is 40 
H2z and corresoonds to refresh(3). To determine the 
refresh rate for different values use the following 
equation: 


DIAGNOSTICS: 


120 / rate = new refresh rate 
All errors will be orinted on the PDPe-i11 terminal 
screen. 
ERROR CAUSE ACTION 
E=-30 Parameter ‘rate' not 1 to 8 Return 
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en. remove 


NAME: 


remove = erase the indicated portion of the picture 
and remove the associated element block 
from the disolay list 


SYNOPSIS: 
pemove (aut, e@bel”,"elec 7% ..e, elelo™): 


int num? PIC / QO all elements 
1 = 10 soecified elements 


To remove the entire picture: 
remove(PIC); 

To remove element structures: 
remove(num,"elel","elec",..); 


DESCRIPTION" 


The entire cicturer or every occurrence of the named 
elements are erased from the vector general disolay 
screen. Each named element structure will be removed 
Prom the display list. The routine removes al] occu 
rances of the specified elements including elements 
constructed with the cooyele() routine. 


To redisplay any portion of the removed oicture re- 
quires that the user rebuild each element and relink 
it to the agopropriate objects. 


The ocarameter ‘num’ specifies the number of element 
names being passed in this routine and may vary from 1 
to 10. 


DIAGNOSTICS: 


All) errors wil) be printed = on the PDF-11 termina) 
screen. 
ERROR CAUSE ACTION 
E=6 Specified element does not Skip 
exist element 
E-128 Parameter ‘num’ not 1 to 10 num = 19 
pies. SEE : 


erase, disolay 
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a 


Rot ate Pelicans 


NAME: 
GOotate =. fpotate an-object 

SYNGPSIS: 
rotate("objname",xradiansryradians [,zradians] )}; 
float xradians,yradians,zradians;3 

DESCRIPTION: 
The named object will be rotated about the x, ve Zz 
coordinate axis. The oarametersy, given in radian meas 
ure, specify the degqree of rotation desired about each 
axiS. 
The z parameter is required only when the coordinate 
system 1s defined as three dimensional and wil! oe 
1QqNO0red otherwise. 

DIAGNOSTICS: 


All errors will be printed on the PDP-1i terminal 


screen. 
ERROR CAUSE ACTION 
E=-5 Soecified objmame does not Return 


exist 
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scale scale 


NAME: 


scale = modify object scale 


SYNOPSIS: 
scale("odjname", scale); 


faleat scale: OOM Ome) 


BecoeRTPTION: 


All elements associated with the named object are 
scaled by the value scale at displav time. The range 
of "Seo lenis trom zerotto one wmNoOrna! or sce fault co- 
peet scaling corresponds to scalet-objname' 71.0). 


DIAGNOSTICS: 


All errors will be orinted on the PDP-11 terminal 
Sc pieen. 
ERROR CAUSE ACTION 

e=5 Specified objname does not Return 

exist 
E=30 Parameter ‘scale, enot moe) tow. U Return 
MSU sce : 
oscale 





S@Wrtvector setvector 


NAME: 
Semvector = specity the vector tyoe and vector mode 
SYNOPSIS: 

gervector(yvtyoe, vnode (xine!) fscale! ), 

liteevit yoe ° 
VR - vector relative 
VRX - vector relative autotincrement x 
VRY = vector relative autorincrement 
VRZ - vector relative autorincrement 2 
VA = vector absolute 
VAX = vector absolute autorincrement «x 
VAY =- vector absolute autowincrement y 
VAZ = vector absolute autorincrement 2z 
INC2 = vector incremental crdimensional 
INCX + vector incremental autorincrement x 
INCY |= vector incremental autorwincrement y 
INC3 |= vector incremental 3-dimensional 

Int vmode: 
LN / 00 = line 
DSH / 020 = dashed line 
DOT 7 040 = dotted line 
PNT / 060 = end point 
DDB /0120 =- dashe-dotedash line 
DDD /0140 = dashw=dotedash line 

float scale: 

MG / 128.0 = add the coordinate increments 
to the high order pits of the 
specified register. 

NMG / 0.0 - 3dd the coordinate increments 
tothe loweorcder bits of the 
soecified register. 

Preoat -'mec, 
DESCRIPTION: 


This routine specifies whicn one of the le vector 
tyoes is to be drawn in the liner move, circle and arc 
instructions which follow. It also specifies the vec= 


tor mode (i.@er liner dottedr, dashed, etc.J,s and if 
required, the increment value for autostincrement vec= 
tors and tne scale fac cor for tncremental vectors. 


The coordinate values oassed in the following draw 


Vie 





setvector setvector 


instructions are denendent on the vector tyvoe selected 
IM this routine. 


This must follow a drawele() call and oreceed any draw 
instructions. This routine can be called any number of 
times within a draw element block. 


The bracketed z parameters are required only when the 
coordinate system has been defined as three dimension= 


Silt 
DAGNOSTICS: 
Al) errors” wil] be printed on the PDPe-11l terminal 
screen. 
ERROR CAUSE ACTION 
7 Routine has been called Return 
outsice a drawele() block 
ES? No soace available in Return 
disolay list 
E=-10 Improoer vector mode vmodge = LN 
E-14 Improper vector tyoe vtype = VA 
E-15 Ssoecified xinc out*of=-bounds xINC = xmin 
or xmax 
Cin wd a0 
E-lo Specified yinc outrof~bounds yince = ymin 
or ymax 
or 0.0 
oe 1/7 SoOeci tiled Zine owt f bor as zine = zmin 
or zmax 
or 0.0 


LS 





setvector = VA setvector = VA 


NAME 3 


VA = vector absolute 


SaNler alo: 


drawele("elename"); 


setvector(VA,vmode); 
move(coordx,coordy ([(,s,coordz] );3 
lineCcoorax,coordy [,coordz]) ; 
Cltele (Gir, centx7,centy Lpeentz) w)5 
arc(dir,centx,centy (,centz) ,endx,endy [,endz) ); 


encele(); 


float coordx,coordy,coordz, 
float centx,centyr,centz,endx,endy,endz; 


DESERTPIION: 


The xs,yrz coordinates of absolute vectors are speci=- 
Beeson th OneSOeect tOeene Of 1 Ginhysonr zero OCOSs)t jon ot 
the user defined coordinate system. Each xr yr 2 coors 
dinate value references a unique point on the display 
screen. Under this vector tyoer coordinate parameters 
for move/line/arc/circle commands which fall outside 
the defined coordinate system will assume a valiue of 
the nearest coordinate within the defined system. 


DRAGNOSTICS: 


All errors will be printed on the PDPeil terminal 
screen. 


ERROR Gavse ACTION 
=| Routine nas been called Return 
outside a drawele() block 
Eee No space available in Return 
disolay list 
E-10 Improper vector mode vmode = LN 
E214 Improoer vector type vtype = VA 
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setvector = VAX setvector = VAX 


NAME: 


VAX = vector absolute autorincrement x 


smuGrSiss 


drawele("elename"); 
Ssetvector(V4X,vmode,xinc);3 
move(cooray [{,coordz}) );3 
lineCcooray {rcoordz] );3 
circle(dir,centy [{,centz] ); 
arcwcdiurr,cemty  (,centziweniavmt,emczin ). 


endele(); 


float xincrvcoordy,rcoordz; 
float centy,centz,endy,endz; 


DESCRIPTION: 


The vector absolute autotincrement x causes the inio 
tial x coordinate value to be 1ncremented or  decre- 
mented by the value specified ty ‘xine’. With every 
move/line/arc/circle command the specified v and 2 
coordinate values are uedated while the x coordinate 
value is incremented by the constant value ‘xince'. 
For examoler the ooint (xryr,2z) becomes point (xtxinc, 
coordy,coordz). Under this vector tyoer coordinate 
pDarameters for move/line/arc/circle commands which 
fall outside the defined coordinate system wil] assume 
a value of tne nearest coordinate within the defined 
system. 


A ane. parameter exceeding onerhalf the coordinate 
range will be set to zero. 


DieaGneastTics: 


All errors will be printed on the PDP-11 termina] 
screen. 


ERROR CAUSE ACTION 

E=!} Routine has been called Return 
outsice a drawele() block 

E=-e No space available in Return 


disolay list 


lee 
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setvector = VAX setvector =VAX 


E=-10 [Imorocer vector mode vmocge = LN 
E14 Imorocer vector type vtype = VA 
E-15 Seecified ‘xine’ outctofsbounds xine = 0.0 
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setvector = VAY setvector = VAY 


NAME 3 


VAY = vector absolute autosincrement y 


SYNOPSIS: 


drawele("elename"); 
setvector(VAY,vmode,yinc);3 
move(coorax {scoordz)] ); 
bimeCeoqordx {,coordz)] ); 
Grrereugdrry,centx.. |,cemtc ane 
arc(dir,centx [,centz],endx [,endz] ); 


endele(); 


float yine,coordx,coordz; 
float centx,centz,endx,end2} 


WESeriPTION: 


The vector absolute auto~mincrement y causes the ini= 
tial y coordinate value to be incremented or decre- 
mented by the value specified by 'yinc'. With every 
move/line/arc/circle command the specified x and 2 
coordinate values are ucdated while the y coordinate 
value is incremented by the constant value ‘yinc'’. 
For examole, the point (x,ry,z2) becomes the point 
(coordx,ytyinc,coordz). Under this vector type, coore- 
dinate parameters for move/line/arc/circle commands 
which fall outside the defined coordinate system will 
assume a value of the nearest coordinate within the 
defined system. 


A yniC. ODarameter exceeding onewhalf the coordinate 
range wil! be set to zero. 


DIAGNOSTICS: 


iiwerrors will ow printed Yon ithe FOP=11 terminal 
screen. 
ERROR GRU Se ACTION 
E~i Routine nas been called Return 
outside a drawele() block 
E=-2 No space available in Return 


disolay list 


ery 





Secrvector > 


eS) 
ee 14 
Sao 


VAY 


Impropoer vector mode 
Imorooer vector type 


Soecified 


"vinc' outcof-bounds 


its 


setvector 


vmode 
vtype 
yinc 


VAY 


LN 
VA 
Ono 





setvector = VAZ setvector - VAZ 


NAME: 
VAZ = vector absolute autorincrement 2 
SYNOPSIS: 
drawele("elename"); 
setvector(VAZ,vmode,zinc)}3 
move (coorcex,coordy); 
line(coorox,coordy); 
circle(dir,centx,centy); 
arcldir,centxrcenty,endx,endy); 
endele(),; 
float z1inc,rcoordx,coordy:; 
float centx,centyrendx,endy; 
DESCRIPTION: 
The vector absolute autotincrement 2 causes the ini= 
tial 2 coordinate value to be incremented or  decre- 
mented by the value specified by ‘zinc'. With every 
move/line/arc/circle command the specified x and y 
coordinate values are uodated while the 2 coordinate 
value 1S incremented by the constant value PZ Vitis vs 
For examole, the point (xr,yr2) becomes the point 
(coordx,cooryrz+?zinc). Under this vector type, coor: 
dinate parameters for move/line/arc/circle commands 
which fall outside the defined coordinate system wil] 
assume a value of the nearest coordinate within tne 
defined system. 
A '2zinc' oarameter exceedina one-half the coordinate 
range will be set to zero. 
DIAGNOSTICS: 
All errors will oe printed on the PDP-11 termina] 
screen. 
ERROR CAUSE ACTION 
E=] Routine has been called Return 
outside a drawele() block 
E22 No space available in Return 


disolay lJ]ist 
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setvector = VAZ ; setvector = VAZ 


E-10 Improper vector node vmode = LN 
E-14 Improoer vector type vtvoe = VA 
E-17 Soecified 'zinc' outrofebounds zinc = 0,0 
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setvector = YVR 


NAME: VR |= vector relative 


SrNOrSisS: 


drawele("elename"); 
setvector(VR,vmode) >; 
move(deltax,deltay {,deltaz] ); 
limne(deltax,deltay {,deltsaz] ); 
ciecle(dir,centx,centy {,cent2] ); 


setvector = VR 


arcldair,centx,centy [,centz2] ,endx,endy [,end2] ); 


endele(); 


float deltax,celtay,deltaz; 
float centx,centy,centz,endx,endy,endz; 


DESCRIP TFON ; 


Relative vectors specify an increment value that is to 
be added to or subtracted from the tnitial x,s,yrz2 beam 
position. For example, the point (x,yrz) becomes 


p0Int (xtdeltax,ytdeltay,ztdeltaz). 


Under this vector tyoe, coordinate 
move/line/arc/circle commands which 


parameters tor 
exceed onechal f 


the coordinate range will be set to zero. 


PPAGCNOSTICS: 


All@errors wil! be printed on the PDP-1i11 terminal 


Screen . 


ERROR CAUSE 


E=1 Routine has been called 
within a drawele() block 

E=2 No space available in 
disolay Jist 

E-10 Improper vector mode 

E-14 Imorooer vector type 


era 


ACTION 
Return 
Return 
vmode = LN 
vtype = VA 








setvector = VRX 


NAMEs 


VRX = vector relative autowincrement x 


SYNOPSIS: 


OGrawele("elename"); 
setvector(VRX,vmode,xinc) 
move(deltay [,deltaz) ); 
line(deltay ([(,aeltaz} ); 
circle(dir,centy [s,centz] )?3 
arc(dir,centy l[,centz])r,endy [,endz} 


® 


endele(); 


float xinc,deltay,deltaz; 
float centyr,centz,endy,endz; 


PESCRIPT LON: 


setvector =~ VRX 


)> 


A vector relative autorincrement x causes the IMVEe Val 
x coordinate value to be incremented or decremented bv 


the constant value ‘xine’. With every 
circle TmStrpuction “that-ssollows, the 


move/line/arc/ 
VY anicnmzecoordi— 


nate values will be uodated, while x 18 steoped by the 


value “xinc’. “For e@xamo!1e, tne CoOlvnt 
the point (xtxincr,y+deltay-ztdeltaz). 


Under this vector tyoe, Coordtmpare 


(xryr,2) becomes 


parameters for 


move/line/arc/circle commands which exceed onerhal f 
the coordinate range will be set to Zero. 


DIAGNOSTICS: 


All errors will be printed on the 
screen. 


ERROR EAQSE 


E-] Routine has been called 
outside a drawele() block 

a= No space available in 
display list 

E=-10 Imoroper vector mode 

E14 Imoroper vector type 

E=15 Specified ‘'xinc' outsof*bounds 


sires 


PDP-tl terminal 


ACTION 
Return 


wy a 





setvector = VRY setvector = VRY 


NAME s 


VRY = vector relative auto-increment y 


orNOUrPSIS: 


drawele("“elename"); 
setvector(VRY,vmode,yinc) 
nmove(deltax [-rdeltaz]} )?3 
line(deltax {,deltaz]} ); 
circle(dir,centx [,centz] )?7 
arc(dir,centx (,centz],endx [,endz] ); 


endele(); 


float yinc,deltax,deltaz, 
float centx,centz,endx,end2; 


PeOGRIPT 1 ON" 


A vector relative auto~tincrement y causes the initial 
y coordinate value to be incremented or decremented by 
the constant value ‘fyinc’. WNith every move/line/arc/ 
Curmele instruction thatttel lows, the x and z coordi- 
nate values will be updated, while y 18 incremented by 
the Value ‘vine’. For example, the point (x,y,z) 
becomes the point (xtdeltaxrytyinc,zt+tdeltaz). 


Under this vector typer, coordinate parameters for. 


move/line/arc/circle commands which exceed oneo-nal f 
the coordinate ranae will be set to zero. 


DIAGNOSTICS: 


All errors wil] be orinted on the PDOPa-1i1 terminal 
screen. 
ERROR CABSE ACTION 
E~} Routine has been called Return 
outsiae a drawele() block 
E=-e No space available in Return 
disolay list 
E-10 Improoer vector mode vmode = LN 
—E-14 Improper vector type vtype = VA 
E=-16 Specified “yime “eull=cf=bounds yume = 0. 0 
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setvector - VRZ setvector = VRZ 


NAME: 
VRZ = vector relative autowmincrement 2z 
SYNOPSIS: 
drawele("“elename"); 
setvector(VRZ,vmode,zinc) 
move(deltax,deltay); 
liretl_deltax,deltay)?; 
circle(dir-,centx,centy); 
arc(dir,centx,centy,endx,endy); 
endele(); 
float zinc,deltax,deltay; 
float centx,centyrenax,endy; 
DESCRIPTION: 
A vector relative autowincrement 2 causes the Jmitia) 
Z coordinate value to be incremented or decremented by 
the constant value ‘zinc’. Nith every move/line/arc/ 
circle lmseruct jon that follows, the x and y coordis 
nate values will be uodated, while 2 1S Incremented by 
the value sera inte For examole, the point (xrsy-2) 
becomes the point (xtdeltax,ytdeltay,ztincz). 
Under this vector tyoe, coordinate parameters for 
move/liine/arc/circle commands which exceed onenmhal f 
the coordinate range will be set to zero. 
DihaGNoSsirtrcs: 


All errors will be printed on the PDPHel!1 terminal 
screen. 


ERROR CAUSE ACTION 
E-1 Routine has been called Return 
outside a drawele() block 
Eee No soace available in Return 
disolay list 
E-10 Imorocer vector mode vmode = LN 
E-14 Improper vector type vtype = VA 
E-17 Soecified ‘zinc’ outeofebounds Zarnc =o 00 
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S@tvector =- INC2 setvector 


NAME: 


INC2 = incremental vector; twoedimensional 


SYNOPSIS: 


drawele("elename"); 
setvectorl(INCe,vmode,scale); 
move(deltax,deltay)7; 
line(deltax,deltay); 


encele(); 
float deltax,aeltay; 


Tioat scale: 

MG 7 128.0 = add the coordinate increments 
the 7 high order bits of the 
sonecified register. 

NMG / 0.0 - add the coordinate increments 
the 7 low order bits of the 
specified reqister. 


PESCRIPTION: 


A twordimensional relative vector that halves 


= [Nee 


to 


ere, 


vector 


storage requirements and doubles the data rate. This 


vector tyoe should be used when element storadce 


a2 4G ¢ 


1S critical. This reduced storage requirement results 
from a limitation on the maximum size of each relative 
increment. The values passed in move/line instructions 
are limited to aprroximately 3% of the user minimum 
and maximum coordinate ranges. Should coordinate 


oarameters for move/line commands exceed the 3% 
tievewi|!! be reduced toesat lary tne comstraint. 


limit, 


The parameter ‘scale’ specifies whether this increment 


value should be added to the 7 high order bits 
specified coordinate or to the 7 low order bits. 


of tne 
This 


scale factor then determines if the increments wi!l be 


applied over a fine(NMG) or coarse(MG) grid. 


Arcs ana circles cannot be drawn with this 
type. 


eS 


VeC Vor 





setvector = INCe 


DIAGNOSTICS: 


All errors will be orinted on the 
screen. 


ERROR CAUSE 


Sil Routine has been called 
outsice a drawele() block 

E=e No space available in 
display list 

E-14 Improoer vector type 
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Set vector = 


PDOP=-1j1 ter 
ACTION 
Return 
Return 


vtype 


INCe 


minal 


= VA 





s@tvector - INC3 setvector - INC3 


NAME: 


INC3 = incremental vector; three=-dimensional 


sraworP ST Sis 


drawele("“elename"); 
Ssetvector(INCxX,vmode,scale);3 
move(deltax,deltay,deltaz); 
line(deltax,deltay,deltaz); 


endele(); 
fioet deltax,cqeltay,deltez, 


ko st SC a) es 
MG / 128.0 = add the coordinate increments to 
the 7 high order bits of the 
soecified register. 
NMG / 0.0 - add the coordinate increments to 
the 7 low order bits of the 
specified register. 


DESCRIPTION: 


A three-dimensional relative vector that halves vector 
storage requirements and doubles the data rate. ieaaes 
vector type should be used when element storage space 
is critical. This reduced storage requirement results 
from a limitation on the maximum $size of each relative 
increment. The values pvassed in move/line instructions 
are limited to aoproximately 3% of the user minimum 
and maximum coordinate ranges. Should coordinate 
parameters for move/line commands exceed the 3% limit, 
they will be reduced to satisfy the constraint. 


The paramater ‘'scale' specifies whether this increment 
value should be added to the /@high order bits of the 
Soecitiea Coordinate “or Co tme"— allow orcer bits. This 
scale factor then determines if the increments will be 
aoplied over a fine(NMG) or coarse(MG) grid. 


Arcs and circles cannot be drawn with Ghiscmsvector 
type. 
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setvector 7 INC3 setvector 7 INCS3 


DIAGNOSTICS: 

All errors will be printed on the PDPHll terminal 

screen. 

ERROR CAUSE ACTION 

E=] Routine has been called Return 
outsiae a drawele() block 

E=-2 No soace available jin Return 
display list 

2 ae Improoer vector type vtyee = VA 
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Setvector = INCX setvector = INCX 


NAME: 
INCX = incremental vector: two-dimensional 
autotincrement x 
SYNOPSIS: 
drawele("elename")7 
setvector(INCX,vmode,xinc,scale)? 
move(deltay,deltay); 
line(deltay,deltay);3 
endele(); 
fiat 8X 1 Memcenct ay > 
fOr, Seale: 

MG / 128.0 -* add the coordinate increments to 
the 7 high order bits of the 
specified register. 

NMG / 0.0 - add the coordinate increments to 
the 7 low order bits of the 
specified register. 

DESCRIPTION: 


A twordimensional relative vector that halves vector 
storaqe requirements and doubles the data rate. This 
vector tyoe should be used when element storage space 
is critical. This reduced storage requirement results 
from a limitation on the maximum s12e of each relative 
increment. The values passed in move/line instructions 
are limited to approximately 3% of the user minimum 
and maximum coordinate ranges. Should the coordinate 
parameters for move/line commands exceed the 3% limit, 
they will be reduced to satisfy the constraint. 


The parameter 'scale'’ soecifies whether this increment 
value should be added to the 7 hiagh order bits of the 
specified coordinate orf to the Felon order bits. This 
scale factor then determines if the increments will be 
apolied over a fine(NMG) or coarse(MG) arid. 


This incremental, autotinerement vector causes the x 
coordinate value to be incremented or decremented by 
the constant value "xine',s while the y coordinate 
value 1s increment oy smal] relative values. The 
xine value need not be TJlimiteqg to 34 of the 


boo 








setvector = INCX setvector ~- INCX 


coordinate range but may not exceed onerhalf the coor 
dinate range or it will be set to zero. 


Ares and circles cannot be drawn with this vector 


tvoe.. 
DIAGNOSTICS: 

All errors will be printed on the PDPe-1! terminal 

screen. 

ERROR CAUSE ACTION 

ES} Routine has been called Return 
outside a drawele() block 

E-2 No space available in Return 
disolay list 

E=14 Improper vector type vtyope = VA 

E=15 Soecified 'xinc' outrofsbounds Kxine = 0.0 
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setvector = INCY setvector - INCY 


NAME: 5 


INCY = incremental vector; two-dimensional 
autotincrement y 


SYNOPSIS: 
drawele(“elename"); 
setvector(INCY,vmoder,yinc,scale), 
move(deltax,deltax); 
line(deltax,deltax); 


endele(); 
float yinc-,deltax; 


float scale: 

MG / 128.0 -* ada the coordinate increments to 
the 7enigheorderseitse of the 
specified register. 

NMG / 0.0 - add the coordinate increments to 
the 7 low order bits of the 
soecified register. 


PESCRIPTION: 


K twordimensiona]l relative vector that halves vector 
storage requirements and doubles the data rate. This 
vector type should be used when element storage space 
1S critical. This reduced storage requirement results 
from a limitation on tne maximum size of each relative 
increment. The values passed in move/line instructions 
are limited to approximately 3% of the user minimum 
and maximum coordinate ranges. Should the coordinate 
parameters of move/line commands exceed the 3% limit, 
they will be reduced to satisfy the constraint. 


The parameter ‘scale’ soecifies whether this increment 
value should be added to the 7 high order bits of the 
specified coordinate Gr Shoummcme n+ |Ow order bits. 
This scale factor then determines if the increments 
will be aoplied over a fine(NMG) or coarse(MG) grid. 


This tneremental, autotincrement vector causes the  y 
coordinate value to be incremented or decremented by 


the constant value ‘'yince’', while the x coordinate 
value 1S increment by smal] relative values. The 
ip en value need not be iimrted rto —S4. of tne 


at 





setvector - INCY setvector = INCY 


coordinate range but may not exceed one-half the coor- 
Ginate range or it will be set to zero. 

Arcs and circles cannot be drawn with this vector 
type. 


OPAGNOS TPES: 


All errors will be printed on the PDP-11 terminal 

screen. 

ERROR CAUSE ACTION 

E=1 Routine has been called Return 
outside a drawele() block 

ae No space available in Return 
disolay list 

E-14 Improper vector type vtyope = VA 

E=-16 Soecified ‘yinc’' outrofs*bounds yine = 0.0 
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NAME : 
SySinit = vector general disolay initialization 
SYNOPSIS: 
Sysinit(devnum); 
int devnum: OL eta 
DESCRIPTION: 
This routine establishes a link with tne vector geno- 
eral, initializes its display system and sets al] the 
user default oarameters, The routine allows’ for 


specification of which VG device the user desires to 
utilize. The VG devices are numbered 0 and 1. Should 
the system be unable to allocate the specified VG dev- 
1ce, allocation of the other VG device will be at- 
temoted. 


This routine must be called before any other display 
yet euctiens. 


PESGNOS ThE Ss 


If initialization of the specified VG device cannot be 
comoleted, an error message will be printed out and 
the system will] attemot to initialize the other VG 
device. The system will terninate the orocess only if 
both initialization attempts fail. 


All errors will be orinted on the PDPH11 terminal 
Seneen . 


ERROR CAUSE ACTION 
E-e7 Imorocper VG devnum specified devnum = 0 
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trans 


trans 

NAME: 

Grans > otirans | aie: obs ect 
SYNOPSIS: 

Upensl sou mMamen,deltax,gdeltay l,deltaz) os 

float deltax,deltay,deltaz; 
DESCRIPTION: 

All o f the elements associated with the named object 


are translatec from their present location (X,Y,2) 


(X+tdeltax,Ytdeltay,Z+deltaz). 


\Gie: 


The 2 sarameter is reauired only when the coordinate 


system is defined as three dimensional, and will be 

19NOred if included under a twordimensional system. 
DIAGNOSTICS: 

All errors will be orinted on the PDP-11 termina] 

screen. 

ERROR CAUSE ACTION 

E=#5 Specified object does not Return 

exist 

E=15 Soecified deltax outsrof*00uNdS deltax = 0.0 

E=-16 Specified deltay outrof=bounds deltay = 0.0 

E=-1/7 Soecified deltaz outcrtof*bounds deltaz = 0.0 
pieSO SEE: 


offset, place 
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viepicture 


NAME: 


vemicture 


SYNOPSIS: 


vapicture 


- start refresh of VG picture display 


vgpicture(); 


BESERIPTION: 


PaaS routine must be called to initiate 
elements on the VG disoclay screen. The 
be called only 
called after this routine to activate 


the cysolay of al} 


DIAGNOSTICS: 


none 


meoo SEE: 


display, 


erases 


ONCe. 


remnove 
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The display() 


theocd)se lay eeu 

routine need 
routine may be 
or deactivate 


or parts of the display picture. 





vgterm 


NAME: 


SYNOPS 


DESERI 


DOIAGNO 


vaterm 
vaterm = terminate display and close VG device 
is: 
voterm(); 
PTION: 
This routine should be iaecrueced “st the endmoenwecne 


user's program to prooerly terminate the display and 
close the VG device. Should the user's program con- 
tain an endless loop, deoressing the 'rubout! key will 
accomolish the same task. 


ST ICS: 


none 
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